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IMPORTANT NOTE 



The information included in this manual is provided by Hewlett-Packard 
to describe the internal organization of MPE. It is not intended to be a guide 
to the modification of MPE. 

Any modification of the tables presented in this manual by HP 3000 users is 
strongly discouraged as serious damage to the operating system may result. 
Furthermore, Hewlett-Packard will not support, correct, or attend to any 
resulting modification of the MPE Operating System Software. 

It is not the intention of Hewlett-Packard to update this manual on any 
scheduled basis. Hewlett-Packard is not responsible for problems arising 
from inaccuracies existing in this manual, nor is it responsible for the cor- 
recting of any inaccuracies. 
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CHAPTER 1 MEMORY LAYOUT 



FIXED LOW MEMORY (SERIES II/III) 










1 
2 

3 
U 

5 
6 

7 
8 

9 
10 

11 


\ 
1 
1 

1 

> 

1 

1 

i 
/ 




ABSOLUTE MEM LOC 


CSTB (BASE OF CST TABLE) 




1 


XCSTB 




2 


DSTB 




3 


PCBB 




1* 


CPCB 


(CURRENT PCB POINTER) 




5 


QI 


(INITIAL Q FOR ICS) 




6 


ZI 


(INITIAL Z FOR ICS) 




7 


MASK WORD 




10 


RESERVED 




11 


RESERVED 


RESERVED FOR 
LOADER MAPPING 
FIRMWARE 


12 


RESERVED 


13 


RESERVED 




1U 







15 


P-LABEL FOR INTERRUPT HNDLR 




16 


DB SET FOR INTERRUPT HNDLR 




17 


U| INTERRUPT INTERVAL VALUE 





U: set if clock interface has been used since coldload 



NOTE: ALL POINTERS ARE ABSOLUTE ADDRESSES. 



1-1 



FIXED LOW MEMORY (SERIES 30/33) 

% - DEC 

0| CSTB (BASE OF CST TABLE)** |0 

1| XCSTB (BASE OF CSTX TABLE)** |1 

2| DSTB (BASE OF DST TABLE)** |2 

31 PCBB (BASE OF PCB TABLE)** |3 

U| CPCB (CURRENT PCB POINTER)** \k 

51 QI (INITIAL Q FOR ICS)** |5 

6| ZI (INITIAL Z FOR ICS)** \6 

71 SYSTEM INTERRUPT MASK WORD** |7 

10 | DBBANK (FOR INITIAL'S STACK)* j 10 
8 

111 DB (FOR INITIAL'S STACK)* |9 

12 | CHANPROG (BUFF FOR DISC)* |10 

i3i in 

1U| SDTYPE (USED BY BOOTSTRAP-SYS DISC)* |12 

151 113 

16 | SPEEDCODE (CODE FOR CONSOLE SPEED)* |lU 

171 TERMCHANPROG (BUFF FOR CONSOLE)* |15 

20 | TAPECHANPROG (BUFF FOR TAPE)* |l6 

21 | LR (INTERRUPT INTERVAL)* |17 

22 | TEMPLR (TEMP STOREAGE OF LIMIT REG)+ |18 

231 PCLC (PROCESS CLOCK LAST COUNT)** |19 

2U| PCHI (PROCESS TIME - MSW)** I 20 
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FIXED LOW MEMORY (SERIES 30/33) (CONT) 

251 PCLO (PROCESS TIME - LSW) # * |21 

26 1 SCST (SYSTEM CLOCK STATUS)** |22 

271 SCLC (SYSTEM CLOCK LAST COUNT)** |23 

30| |2U 

31-371 TEMP'CPVA (TEMPORARY CPVA)* 1 25-31 

NOTE: ALL POINTERS ARE ABSOLUTE ADDRESSES. 

LEGEND: ** NEEDED BY FIRMWARE AND/OR BY SYSTEM, ALWAYS 
* NEEDED DURING INITIAL 
+ NEEDED BY MPE, SET UP BY INITIAL OR PROGENITOR. 
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FIXED LOW MEMORY (SERIES Uk) 



% DEC 

01 



1 
2 
3 
k 

5 
6 

7 

10 

11 

12 

13 
1U 

15 
16 

17 
20 
21 
22 

23 

2k 



CSTB (BASE OF CST TABLE)** |0 

XCSTB (BASE OF CSTX TABLE)** |1 

DSTB (BASE OF DST TABLE)** !* 

PCBB (BASE OF PCB TABLE)** |3 

CPCB (CURRENT PCB POINTER)** \k 

QI (INITIAL Q FOR ICS)** 15 

21 (INITIAL Z FOR ICS)** \6 

SYSTEM INTERRUPT MASK WORD** |7 



DBBANK (FOR INITIAL'S STACK)* |10 
8 

DB (FOR INITIAL'S STACK)* |9 



CHANPROG (BUFF FOR DISC)* |10 

111 
SDTYPE (USED BY BOOTSTRAP-SYS DISC)* |12 

113 

SPEEDCODE (CODE FOR CONSOLE SPEED)* \lk 

TERMCHANPROG (BUFF FOR CONSOLE)* |15 

TAPECHANPROG (BUFF FOR TAPE)* |l6 

LR (INTERRUPT INTERVAL )+ |17 

TEMPLR (TEMP STOREAGE OF LIMIT REG)+ |18 

LR (SYSTEM CLOCK LIMIT REGISTER) |19 

/////////////////////////////////////////////|20 



1-k 



FIXED LOW MEMORY (SERIES kk) (CONT) 

251 TR (TIME SINCE LAST SOFT TIMER INTERRUPT) |21 

26| SCST (SYSTEM CLOCK STATUS)** |22 

271 SCLC (SYSTEM CLOCK LAST COUNT)** |23 

30| \2k 

31-371 TEMP'CPVA (TEMPORARY CPVA)V 1 25-31 

NOTE: ALL POINTERS ARE ABSOLUTE ADDRESSES. 

LEGEND: ** NEEDED BY FIRMWARE AND/OR BY SYSTEM, ALWAYS 
* NEEDED DURING INITIAL 
+ NEEDED BY MPE, SET UP BY INITIAL OR PROGENITOR. 
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SYSTEM GLOBAL AREA 



octal 



name 



01 



II 

I 
21 

I 
31 

I- 
h\ 

I- 
51 

I- 
61 

I- 
71 

I- 
10 1 

I- 
HI 

I- 

12! 

I- 

131 

I- 
lk\ 

I- 

151 
I- 
161 

I- 
171 

I- 
20 1 

I 
211 



22 1 

I 

231 



2k\ 

I 

251 



SYSGLOB - SYSBASE 



CST BASE - SYS BASE 
DST BASE - SYS BASE 



PCB BASE - SYS BASE 
ARSBM BASE - SYS BASE 



IOQ BASE - SYS BASE 
SBUF BASE - SYS BASE 



ICS QI - SYS BASE 
LPDT BASE - SYS BASE 



STOPS BASE - SYS BASE 
TRL BASE - SYS BASE 



JCUT BASE - SYS BASE 
SIR BASE - SYS BASE 



JPCNT BASE - SYS BASE 
TBUF BASE - SYS BASE 



MONBUF BASE - SYS BASE 
FIRST FREE MEMORY ADDRESS 



TIME OF LAST CYCLE 



RESERVED 
SWAPTAB BASE - SYSBASE 



ISYSCST 

JSYSDST 

ISYSPCB 

ISYSARSBM 

ISYSIOQ 

ISYSBUF 

ISYSICS 

ISYSLPDT 

ISYSBPT 

JSYSTRL 

ISYSSIR 

JSYSSDCTAB 

j SYS JPCNT 

ISYSBUF 

ISMONBUF 



ISYSSWAPTAB 



1-6 



26| 
271 
301 
31 1 
32| 
331 
3U| 

351 
36| 
371 
U0| 
Ul| 
U2| 
U3I 
kk\ 

U5I 
U6| 

U7I 
50 1 
51 1 
52! 
531 
5M 



VDSMTAB BASE- SYSBASE 



CURRENT CST BLOCK INDEX 
DISCREQTAB BASE - SYS BASE 



DISPLACEMENT TO CODE =@CST(0)-gDST(0) 
DISPLACEMENT TO SHARABLE = gCST(LAST)-§DST(0) 



Global Class Enable Mask 
ABS ADDRESS (SYSDIT(8)) 



Statistics Gathering XDS Bank 
Statistics Gathering XDS base 



RESERVED FOR INITIAL (VDSENTRY) 
RESERVED FOR INITIAL (VDSMAP) 



SRTTAB BASE - SYS BASE 
SPECQ HEAD - SYS BASE 



ARL BASE - SYS BASE 
# PAGES IN LARGEST CURRENTLY AVAILABLE REGION 



MAKE OVERLAY CANDIDATE INFORMATION 

NUMBER OF MEMORY BANKS CONFIGURED -1 



SCHEDULER TO AWAKE MESSAGE 
POINTER TO CSTBLK TABLE 



AWAKE TO SCHEDULER MESSAGE 
WAIT TO SCHEDULER MESSAGE 
CURRENT ACTIVITY'S PRIORITY 



VDSMTAB 

CSTBX 

SYSDISCREQTAB 

DFC 

DFS 

GCLASSENMASKP 

SYSDIT8 

STATGATHXDSBANK 

STATGATHXDSBASE 



SRTTAB 

SYSSPECQHEAD 

SYSARLD 

SYSMAXAVAILREG 

MOCINFO 

SYSNBANKS 

SCHEDTOAWAKEMSG 

CSTXBLOCKPOINTER 

AWAKETOSCHEDMSG 

CURACTPRI 
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SYSTEM GLOBAL AREA (cont) 



octal 



name 





/55I 
1 1- 
1561 

1 1 
1571 

1 1 
I60| 

1 1 
|61| 

1 1 
I62| 

1 1 
1631 

1 1 

1641 

< | 

1651 
1 1 
I66| 

1 1 

|67| 

1 1 
|70| 

1 1 
I71| 
1 1 
|72| 

1 1 
1731 
i 1 
\74| 

/ 751 

1 76| 
1 77| 
|100| 
|101| 




BUSY TABLE POINTER 


BUSY 






HEAD TABLE POINTER 


HEAD 






TAIL TABLE POINTER 


TAIL 






# OF SIO PROGRAMS EXECUTING 


SIOCOUNT 






PARITY ERROR FLAG (MEM PE) 


PARITY 




Impeded queue head for message buffer (PIN) 


IOMSGPIN 




(0:1) 
(1:1) 


I/O Message system error flags 

- No SYSBUF avail for I/O error logging 

- No SYSBUF for IOMESSAGE (GENMSG) 


IOLOGQX 


reserved 
for I/O 
system 




# OF TERMINALS READING 


RDCOUNT 




# OF TERMINALS WRITING 


WRTCOUNT 






DSET B 


CRIO 






LAST TIMER 


CRIO 
CRIO 






HIGHEST DRT NUMBER 


HSYSDRT 






POWERFAIL 


POWERFAIL 






SYSTEM UP FLAG 


SYSUP 






SYS CONSOLE LOGICAL DEVICE NUMBER 


CONSIDEV 






COLD LOAD COUNT 


ICLOADID 






SHARED FCB DST 


i SHFCBDST 






MONITORING FLAGS 




reserved 
for file< 
system 




MAX # OF SPOOL SECTORS 


IMAXSSECT 
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|102| 
1 1 

11031 
■ | 


CURRENT w OF SPOOL KILOSECTORS j 


U04I 


# SECTOR/SPOOFLE EXTENT j 


105 


MAX CODE SEGMENT SIZE | 


106 


MAX # OF CODE SEGMENTS/PROCESS | 


107 


MAX STACK SIZE (MAXDATA) | 


110 


DEFAULT STACK SIZE j 


111 


MAX EXTRA DATA SEGMENT SIZE | 


112 


MAX # EXTRA DATA SEGMENTS/PROCESS | 


113 


DST number for MESSAGE buffers I 


114 


UPDATE LEVEL j 


115 


FIX LEVEL 1 


116 


VERSION LEVEL | 


117 


DEFAULT CPU TIME LIMIT 1 


120 


# OF SECONDS TO LOGON 1 


121 


JOBSYNCH BITS (13:3) 1 


122 


EXTERNAL PLABEL OF INITIATE | 


123 


INTERNAL PLABEL OF INITIATE | 


124 


MAXSYSDST | 


125 


MAXSYSCST | 


126 


! SL. PUB. SYS LDEV | SL. PUB. SYS | 


127 


| DISC ADDRESS | 


130 
131 


! (DIRECTORY) | 
| (DISC ADDRESS) | 



NUMSSECT 



EXTSSECT 



UPDATEL 

FIXL 

VERSION 
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SYSTEM GLOBAL AREA (cont) 



octal 



name 



132 


SPOOLINDEX 


/133 

1 


EXT LABEL FOR SHOWCOM 


I13U 

1 




1135 


CS IOWAIT PLABEL 


for CS |136 
j 


I CS FIX LEVEL 


U37 

| 


CS VERSION 


\1U0 


CCLOSE PLABEL 


1141 


LOGICAL PROCESS TABLE (PROGEN) 





1U2 


IIIIIIIIIIIIIUIIIIIIIfllllllflllltllllllllHIl 


1U3 


LOGICAL PROCESS TABLE (UCOP) 


2 


Ikk 


LOGICAL PROCESS TABLE (PFAIL) 


3 


1U5 


LOGICAL PROCESS TABLE (DEVREC) 


\ 


1U6 


LOGICAL PROCESS TABLE (DRUSG) 


5 


II47 


LOGICAL PROCESS TABLE (STMSG) 


6 


150 


LOGICAL PROCESS TABLE (LOG) 


7 


151 


LOGICAL PROCESS TABLE (LOAD) 


8 


152 


LOGICAL PROCESS TABLE (IOMESSPROC) 


9 


153 


LOGICAL PROCESS TABLE SYSIOPRDC 


10 
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151) 


1 LOGICAL PROCESS TABLE MEMLOGP 11 1 


155 


1 EXTERNAL PLABEL OF "TERMINATE" | 


156 


j INTERNAt PLABEL OF "TERMINATE" j 


157 


1 EXTERNAL PLABEL OF "COMMANDINTERP" | 


160 


1 INTERNAL PLABEL OF "COMMANDINTERP" | 


161 


1 EXTERNAL PLABEL OF "SPOOLIN" | 


162 


1 INTERNAL PLABEL OF "TRACEO" | 


163 


1 EXTERNAL PLABEL OF "TRACEO" j 


16k 


INTERNAL PLABEL OF "SPOOLIN" | 


165 


EXTERNAL PLABEL OF "SPOOLOUT" | 


166 


INTERNAL PLABEL OF "SPOOLOUT" | 


1 167 


3 WORD | 


! 170 


LOGGING j 


1 171 


MASK | 


1 172 


///////////I STATE | DST# - BUFFER | 


1 1731 


/////////// i STATE i DST# - BUFFER 1 | 


i 17U| 


BUFFER LENGTH (SECTORS) | 


1 1751 


FREE AREA POINTER | 


1 176 1 
reserved | 


FLAGX | 


for 177| 

logging J 

I 200| 


# RECORDS WRITTEN IN BUFFER | 


# RECORDS WRITTEN IN BUFFER 1 | 


1 201) 


FILE SIZE (BLOCKS) - 1ST HALF j 


! 202I 


FILE SIZE (BLOCKS) - 2ND HALF j 


1 2031 


(LOG FILE SIZE) | 


1 20U| 


(BLOCKS) | 


1 2051 


LOG FILE NUMBER (LOGFILENUM) | 



STATE: 

EMPTY 

1 CUR 
2. FULL 
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I I 

I 206 1 NUMBER OF LOGGING [BLOCKS WRITTEN (1ST HALF)] 

I I 

| 207| BLOCKS WRITTEN [BLOCKS WRITTEN (2ND HALF)] 

I 
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SYSTEM GLOBAL AREA (cont) 



octal 



name 



logging 



RTM 



210 
211 
212 
213 
2lU 

215 
216 

217 
220 



(TOTAL # LOG RECORDS MISSED) 
(DUE TO LOG FAILURE) 
TOTAL* RECORDS MISSED - "JOB INITIATION" LOSS 
TOTAL* RECORDS MISSED - "JOB TERMINATION" LOSS 
OPERATOR CONSOLE JOBSESSION # AT STARTUP 
GLOBAL 
ALLOW 
MASK 



LOADER 

MESSAGE 

TABLE 



I 



250|F| 

I 

25H 

I 

252|E|T|ERR| 

I " 

2531 EXTRA DATA SEGMENT ADDRESS 

I — - 



ACTIVE RTM COUNT 

ADDRESS OF RTM XDS 
XDS BANK NUMBER 



BANK 



RTMFLAG 
RTMADDR 
XDSBANK 
XDSADDR 
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segment 25^1 
trace ! 
I 2551 
I I 
I 256| 
I I 
2571 

260 1 
26l| 
262| 
263 i 
26U| 
265I 
266| 
2671 
270| 
2711 
272| 
2731 
27fc| 
2751 
276 1 
2771 

300| 
301| 

302| 

3031 



misc 



CURRENT WORD COUNT 
BUFFER SIZE 



MAG TAPE LDEV 
TRACE SEGMENT EXTERNAL LABEL 
STMON 
MEASINFOTABPTR 
MEASUREMENT STATISTICS CLASS MASK 
CLASS STATISTICS BANK NUMBER 
CLASS STATISTICS ADDRESS 



I 

! XDSCOUNT 

BUFFSIZE 

LDEV 

TLABEL 



SCAN POINT 



MEASFLAGS 



Sysbase index of PCB at head of Dispatching Q 



Sysbase index of PCB at tail of Dispatching Q 
RESERVED JB 



RESERVED JB 
RESERVED JB 



HELP LOGICAL DEVICE NUMBER 
CURRENT LOGON DST 



(STOP) 

(BITS) (see p. 1-2U) 



# PROCESS ENTRIES 



GCLASSENABLEDMASK 

MEASSTATXDSBANK 

MEASSTSTXDSBASE 



#• 



S7SDISQHEAD 
SYSDISPQTAIL 



DSTLOGON 



1-lU 



process 

stop 

table 



301* 
305 
306 
307 
310 
311 
312 
313 
31U 

315 
316 

317 
320 
321 
322 
323 
DS 32U 
325 
326 
327 
330 
331 
332 
333 
33*t 



DEVREC PIN | 


2 


%20 


UCOP PIN | 





%20 


LOG PIN | 


1 


%20 


IOMESS PIN | 


3 


%20 


MEMLOGP PIN | 


k 


%20 






DSGLOBAL DATA SEGMENT DST NUMBER 


RESERVED FOR DS/3000 


(SET TO ZERO) 


RESERVED FOR DS/3000 


(SET TO ZERO) 


SDSLDEV PLABEL 


RESERVED FOR DS/3000 


(SET TO ZERO) 


RESERVED FOR DS/3000 


(SET TO ZERO) 


RESERVED FOR DS/3000 


(SET TO ZERO) 


RESERVED FOR DS/3000 


(SET TO ZERO) 


DISC STATUS 


LDEV | 


DISC 


AONESS 


MAXQUEUE 


DEFAULTQUEUE 



LAST 
DISC 
SIO 
ERROR 



JOBPRI 
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3351 




DSCHECK PLABEL | 


336! 




DSOPEN PLABEL ! 


3371 




DSCLOSE PLABEL | 


340| 




MANAGEWRITE CONV. PLABEL | 


34H 




CONSDSLINE' PLABEL | 


3421 




CXREMOTE PLABEL | 


3431 




CXDSLINE PLABEL | 


3441 




CXRFA PLABEL | 


3451 




DSIMAGE PLABEL | 


3461 


DEFAULT 


LABEL TYPE | TAPE LBL AUTO REC FUN | 


3471 


SYSDB PTR TO TERM INIT CHNL PGM (S30/33 ONLY) | 


350| 




Reserved j 


3511 
352| 




LAST CYCLE DURATION | 


3531 
3541 




CYCLE THRESHOLD | 


3551 


BUG 


CATCH ENABLE CELL | 


3561 


MONITOR BUFFER | TIMESTAMP | MONBUFTO 


3571 


MONITOR BUFFER | TIMESTAMP | M0NBUFT1 


360| 




DSBREAK PLABEL I 


3611 


Bank of 


last memory word |LAST MEMORY 


362| 


Base of 


Last memory word j ADDRESS 


/363I 
1 | 




PVPROC PIN i 


13641 
Private < | 
Volumes | 365 1 

1 1 




PV RECOGNITION COUNT 1 


VMOUNT 


FLAGS | AUTO | ALL | ON| 
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1366 

I 
1367 

\370 

371 

372 

373 

37U 

375 

376 

377 







' 


HSG CATALOG LDEV | 


MESSAGE CATALOG DISC ADDRESS 


HSG DSTN 


CONSMPLIHE" PLABEL 


CONSMRJE PLABEL 


SYSTEM LEVEL UDC FLAG (1 = SYS UDC'S EXIST) 


SYSDB RELATIVE POINTER TO SYSGL06 EXTENSION 
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SYSGLOB EXTENSION (%200 LONG; POINTER AT SYSDB+J377) 



% 
1 

2 

3 

k 

5 
6 
7 
8 

9 



Swap Queue Delay (*100mfl) 



Bank of First Region in Linked Memory 
Base of First Region in Linked Memory 



Garbage Collection Enable Flag 
Move Threshold (in pages, for garb coll) 



Main Memory Page Size (in words) 
VDS PAGE SIZE 



LAST MAKE ROOM TIME 



MEMORY PRESSURE DURATION THRESHOLD 



SWAPQDELAY 

FIRST 

MEMORY 

REGION 

GARBCOLLENAB 

MOVETHRESH 
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57 
60 

6l 
62 

63 
6k 

65 
66 

67 
70 
71 
72 
73 
7U 
75 
76 
77 

100 
101 



///////////////////////////////////////////////I 


PLABEL USERLOG (EXTERNAL) | 


PLABEL USERLOG ( INTERNAL) 


PLABEL RECLOG (EXTERNAL) | 


PLABEL RECLOG (INTERNAL) 


PLABEL RESTART (EXTERNAL) 


PLABEL RESTART (INTERNAL) 






RESERVED FOR IMAGE 


RESERVED FOR MEASIO 12 1 MIOCNT 


LOADER CACHE SEGMENT NUMBER 


[ PLABEL 3270 (EXTERNAL) 


| MIT UPDATE 


| MIT FIX 


| MIT VERSION 


| COUNT OF TAPE CONTROLLERS USING MEASIO 


| PORT DATA SEGMENT NUMBER 


| RESERVED FOR SECOND PORT DATA SEGMENT 



* MIOCNT = MEASIOCOUNT (3 BITS) 
** MEASFLAGS (15:1) = 1 ==> MONITOR ENABLED 
(lU:l) = 1 ==> BUFFER FLIP/FLOP 
(13:1) = 1 ==> EOT ON MONITOR TAPE 
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SYSDB WORDS 


ADDRESS 


NAME 


DB+55 


BUSY 


DB+56 


HEAD 


DB+57 


TAIL 


DB+60 
DB+72 


SIO COUNT 
POWER FAIL 


DB+73 
DB+7U 


SYSUP 
CONSLDEVN 



FUNCTION 

SYSDB relative pointer to BUSY TABLE for 

I/O resources 

SYSDB relative pointer to table containing 

head pointers to I/O resource queues 

SYSDB relative pointer to table containing 

head pointers to tail of I/O resource queues 

Number of I/O Programs currently executing 

0-no power fail 

1 -system disc recovery 

2 -all other disc recovery 

3-all other device recovery 

System is up and operable 

System console logical deviee number 



JOBSYNCR job synchronization via jobsynch (sysglob+121(8)) 



(13:1) - JOBSREADY - set by DEVREC & MORGUE (via procedure STARTDEVICE) 

indicating a ready job. This prevents UCOP from 
going to a wait state when a job is just made 
ready. 

(15:1) - DEVFREED - set by DEALLOCATE when device count goes to 0. 

NOTE - Both bits above used for synchronization of job-made-ready or 
devicefreed when UCOP is running. 

(ll»:l) - JOBSWAITING- set by UCOP just before waiting if any job is 

waiting for list device. Signals DEALLOCATE to 
awake UCOP when a device is freed. 
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ALLOW MASK FORMAT 



WORD 1 



WORD 2 



BIT 


COMMAND 





ABORTIO 


1 


ACCEPT 


2 


DOWN 


3 


GIVE 


k 


HEADOFF 


5 


HEADON 


6 


REFUSE 


7 


REPLY 


8 


STARTSPOOL 


9 


TAKE 


10 


UP 


11 


MPLINE 


12 


DSCONTROL 


13 


ABORTJOB 


Ik 


ALLOW 


15 


ALTSPOOLFILE 





ALTJOB 


1 


BREAKJOB 


2 


DELETESPOOLFILE 


3 


DISALLOW 


k 


JOBFENCE 


5 


LIMIT 


6 


STOPSPOOL 


7 


SUSPENDSPOOL 


8 


OUTFENCE 


9 


RECALL 


10 


RESUMEJOB 


11 


RESUMESPOOL 


12 


STREAMS 


13 


CONSOLE 


Ik 


WARN 


15 


WELCOME 
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WORD 3 






MON 


1 


MOFF 


2 


VMOUNT 


3 


LMOUNT 


U 


LDISMOUNT 


5 


MRJECONTROL 


6 


JOBSECURITY 


7 


DOWNLOAD 


8 


MIOENABLE 


9 


MIODISABLE 


10 


LOG 


n 


FOREIGN 


12 


IMLCONTROL 


13 


SHOWCOM 
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LOGGING- RELATED LOCATIONS 



STSDB 

1 2 3 *» 5 6 7 8 9 10 11 12 13 lU 15 

or | /////////// | STATE | DST # | 
173 I - I 

STATE = if respective buffer empty 

1 if respective buffer is current 

2 if respective buffer is full 



FLAGX 



SYSDB 

1 2 3 U 5 6 7 8 9 10 11 12 13 Ik 15 

176 | //////////////////////////////// | SF | HF | BUF | SL | SD | 
I 1 

SF = 1 if soft failure 
HF = 1 if hard failure 
BUF = if current log buffer is buffer 
= 1 if current log buffer is buffer 1 
SL = 1 to indicate a switch in log buffers (from to 1 or from 1 

to 0) 
SD = 1 to indicate shutdown in progress 
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OPT AND SEGMENT TRACE CELLS 



SYSDB 

RTMFLAG* 250.(0:1) 

.(1:11) 
.(12:U) 

RTMADDR* 251 



set if RTM enabled 

# of active RTM processes 

bank # of RTM xds 



XDSBANK 252.(0:1) E 
.(1:1) T 
.(2:2) ERR 



set if segment tracing enabled 

buffer toggle 

error code for MEASIO 

= no error 

1 = unrecoverable error 

2 = EOT - end of tape 
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PROCESS STOP LIST GENERAL LAYOUT 
SYSDB 



300 



317 



STOP BITS REPRESENTING WHICH 
PROCESSES TO STOP ON "SHUTDOWN" 



# PROCESS ENTRIES 

/////////////////////////////////////////////// 
1ST PROCESS ENTRY 
2ND PROCESS ENTRY 



LAST PROCESS ENTRY 



ENTRY FORMAT 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
PROCESS PIN # | STOP BIT # 



PROCESS WAIT STATE 



PREASSIGNED ENTRIES 



entry # process stop "bit # 



1 devrec 2 

2 ucop 

3 log 1 
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Initial Memory Allocation 



This section is a description of the method used by INITIAL to allocate 
memory for MPE tables and code segments in MPE IV. All memory allocated 
by INITIAL is permanently allocated. All non-core resident code and 
data is put on disc before exiting INITIAL. 

At the most basic level INITIAL will try to build memory to look exactly 
as diagrammed below. There are, however, several ways in which to de- 
viate from this structure. Before going into the sources of these de- 
viations, it is necessary to point out which portions of memory are used 
by INITIAL during the restart and therefore cannot be used by MPE until 
INITIAL has finished. Before INITIAL begins to allocate any memory 
space, it relocates its core resident code, its code segment swapping 
area and its stack to the highest configured memory space. Addition- 
ally, it uses the last %2U0 words of bank on a series III and the last 
%326 words of bank on series 30, 33 and UU for its I/O buffer area and 
temporary code segment table. After INITIAL has built all of core res- 
ident MPE (tables and code), it builds the disc resident MPE tables. 
Since some of the disc resident tables may be too large to be built in 
INITIAL'S stack, these tables are built in unused memory space. There- 
fore, in addition to the memory space required for INITIAL'S code, 
INITIAL'S stack and core resident MPE, there must be enough space left 
in which to build the largest of the disc resident tables. 

INITIAL will essentially build memory in the order shown below, however, 
there may be an unused fragment of memory between the DRT's and the sys- 
tem global area which INITIAL will fill with the smaller tables. Nei- 
ther the tables marked with an asterisk nor the code segments will ever 
be put in this area. 

Beginning with the B MIT, all bank dependencies have been removed from 
core resident MPE code. If there is insufficient space in bank for 
any core resident code segment, INITIAL will put it into bank 1. At the 
present time core resident MPE is not large enough to occupy more than 
all of bank and part of bank 1. If the system being built by INITIAL 
is configured with 128K words or l60K words of memory then INITIAL'S 
stack will be in bank 1 (the code also on a 128K word memory size) . If 
INITIAL is occupying part of bank 1 and the space is needed for a core 
resident MPE code segment or to build a disc resident table then INITIAL 
will print the error message "ERROR #350 OUT OF MEMORY" . 

Except for the ecxeptions stated above, for every allocation of memory 
INITIAL will first try to allocate any remaining space between the DRT's 
and SYSDB. It will then try the next available space in bank 0, then 
the next available space in bank 1. If it were necessary it could con- 
tinue searching until all all banks were checked for available space. 



1-26 



Immediately before exiting INITIAL, INITIAL lays down all the memory 
region headers and trailers as shown below. For any one bank of memory 
there will only be one block of core resident MPE, regardless of its 
contents. The only block of core resident MPE that does not have a re- 
served region global header is in bank 0. It does have the reserved 
region global trailer though. Before placing any code outside b ank 
the first %23 words of every bank (except bank 0) is reserved for the 
region global header. 
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i nun inn bank o ////////////// 

Low Core memory 
DRT 
System Global area 

Firmware area 
SYSGLOB Extension 
TBUF's 
•DIT's 
DST 
CST 
CSTX 
PCB 
ICS 
*IOQ 
Disc Request Table 

ILT/DLT 
I/O resource Table 
'System Buffers 

Swap Table 

CST Block Table 

Special Request Table 

Message Harbor Table 

Primary Message Table 

Measurement Information Table 

VDSMTAB 
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ARSMB Table 

Available Region List 

LPDT 

Timer Request Queue 

Job Process Count 

Job Cutoff Table 

Sir Table 

Memory Management Monitor Buffer 



Core Resident CST's in CST order 



Reserved Region Global Trailer 
Available Region Global Header 



Available Memory 



Available Region Global Trailer 

/////////// BANK 1 II I III II mm 

Reserved Region Global Header 
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Core Resident CST's that didn't 
fit in BANK 



Reserved Region Global Trailer 
Available Region Global Header 



Available Memory 



Available Region Global Trailer 
I III III II I BANK BOUHDRY ////////// 
Available Region Global Header 



Available Memory 



Available Region Global Trailer 
I II I III III BANK BOUNDRY ////////// 

ETC. 
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CHAPTER 2 Memory Management Tables 



2.1 Segment Table Structure 

The. current location and state of each data segment and loaded code 
is maintained in the segment table. This table is partitioned into 
parts, as shown in Figure 2-1. The partitions are based on the seg 
classes: a segment is a data segment, a segment is a system si seg 
segment is part of a program. The structure and format of each par 
is described in the following. 



(%2),(%1002)+SYSBASE 



(%0),(%1001)+SYSBASE 



Overall ST Structure 
-> + + 

DST 



•> + 



(%1051) - 



CSTXMAP 


i 


>l 


1 


i 
1 
1 


1 


1- 


— +. + 


+-• 
1 

1 
1 


1 
1 

! 




1 


1- 

1 
1 




1 

1 

1 








Figure 2-1 



•>+ 



CST 



First 
Loaded 
Program 



Next 

Loaded 
Program 



+< " (%3)» current program po 
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2,1.1 Pointers and DST #'s of Segment Table Cewpcr-ents 
i. DST 

% 2 absolute address of entry of the DST 
J11002 sysbase relative index of entry of DST 
DST# «2 

ii. CST 

% absolute address of entry of system si 

JtlOOl sysbase relative index of entry of system si 

%1032 displacement from DST base of entry of system si 

■ I CST - 6 DST "DPC 
DST# »1 

ill. CSTX 

% absolute address of entry of current program 
$.033 displacement from DST base to first CSTX entry si 

- t CST (LAST) - DST (0) » DPS 
DST# -1* 

iv. CSTXMAP 

fllOJl sysbase relative index of entry of CSTXMAP 
DST# 'ki {%71) 
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STANDARD SEGMENT IDENTIFIER FORMAT 



I. SEGMENT IDENTIFIER FORMAT 

SEGIDENTIFIER.(0:1) = 1 ==> SEG IS PART OF A PROGRAM 

==> (1:7) = PROGRAM INDEX INTO CSTXBLK, 
(8:8) = LOGICAL SEG NUMBER (0-255) 
SEGIDENTIFIER.(0:2) = ==> SEG IS A DATA SEGMENT, 

(2:lU) = DST ENTRY NUMBER 
SEGIDENTIFIER.(0:2) = 1 ==> SEG IS AN SL SEGMENT, 

(2:lU) = SL ENTRY NUMBER 
EQUATE SEGIDDATATYPE=0, 

2.1.3 DST Entry Formats 

DST Entry Format 

1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

Word 0|f OF CONFIGURED ENTRIES 

I " - 

Word 1 | ENTRY LENGTH 

I 

Word 2|# OF AVAILABLE ENTRIES 



I 
Word 3 | TABLE RELATIVE INDEX TO FIRST FREE ENTRY 



I 



Word 
Word 1 



Word 2 
Word 3 



DST General Entry Format 
Case (i) DST Entry for a Present Data Segment 



1 2 3 *» 5 6 7 8 9 10 11 12 13 1U 15 
„|..|..|-|..|..|-|-|-|-|-|-|--|-|-l- 
A |0 |R | SIZE/U 



D |R |I |S |M |F |S |C |W| 

C |0 |M |T |0 |W |Y |0 |D| 

V |C |I |K |D |I |S |R | | 

I I I I IP I IE | | 



VMALLOC 



BANK 
BASE 



FIRMINFO 
FLAGS 

MMBANK 
MMBASE 
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Word 
Word 1 



Word 2 
Word 3 



Case (ii) DST Entry for an Absent Data Segment 



1 2 3 U 5 6 7 8 9 10 11 12 13 11* 15 
A |0 |R | SIZE/U 



D |R |Z |S |M |F |S |C |W| 

C |0 |M |T |0 |W |Y |0 |D| 

V |C |I |K |D |I |S |R | | 

I I I I IP I IE | | 



VMALLOC 



L DEV # 



HODA 



LODA 



FIRMINFO 



FLAGS 



HODA 
LODA 
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2.1.6 CST Entry Formats 



CST General Entry Format 

Case (i) CST Entry for a Present SL Segment or CSTX Segment 



1 2 3 ** 5 6 7 8 9 10 11 12 13 1U 15 
Word |A |M |R |T | SIZE/U 



Word 1 |/ |R |I |/ |/ |/ |S |C | ///////////////////// 

!/ 10 |M |/ |/ | /|Y |0 I////////////////////// 

1/ IC |I 1/ 1/ 1/ |S |R I////////////////////// 

1/111/ 1/ 1/ I IE I////////////////////// 

Word 2 I BANK 



Word 3 I 

I 



BASE 



FIRMINFO 
FLAGS 

MMBANK 
MMBASE 



Case (ii) CST Entry for an Absent Segment SL or CSTX Segment 



1 2 3 ^ 
l-l-l-l-l-l 
Word |A |M |R |T | 



5 6 7 8 9 10 11 12 13 1U 15 
-l-l-l-l-l-l-l-l-l-l- 
SIZE/U 



Word 1 |/ |R |I |/ |/ |/ |S |C | ///////////////////// 

1/ 10 |M |/ |/ | /|Y |0 I////////////////////// 

1/ ic |i 1/ 1/ 1/ is |r MllliflllllllliUUlU 

1/ I I 1/ 1/ 1/ I IE MIIIIIIIIIIIUIIIIIIII 

Word 2 | L DEV # | HODA 



Word 3 I 
I 



LODA 



FIRMINFO 



FLAGS 



HODA 
LODA 



2.1.7 ST Entry Field Descriptions 



A = 1 = 
M = 1 = 
R = 1 = 
T = 1 = 
DCV = 1 
STK = 1 = 
MOD = 1 = 
FWIP= 1 
VMPAGECNT 
ROC = 1 = 
IMI = 1 
SYS = 1 
C0RE= 1 
WD= 1 



> 

> 

> 

> 

=> 

=> 

=> 



=> 

=> 
=> 
=> 
=> 



segment absent 
segment privileged 
segemnt has been referenced 
segment is being traced 

disc copy is valid 

segment is a stack 

a segment modification (exp. , contr.) is pending 
> a forced write of this segment is in progress 

I of virtual memory pages allocated to this segment 

segment is recoverable overlay candidate 

segment is in motion in 

segment is a system segment 

segment is core resident 

write disabled 
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TABLE FORMAT-CSTBLK 



CSTBLK(O)- 



* NUMBER OF ENTRIES IN TABLE 



* ANT UNASSIGNED ENTRY = -1 



* ANY ASSIGNED ENTRY > 



* REMAINING CSTBLK TABLE ENTRIES 






« 
* 



* 
» 



* 



COMMENTS - 

The table is initialized to minus one in each entry. When selected, 
the entry is replaced by a DST-relative index into the CST extension 
block. 
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2.1.8 Program Blocks and the CSTXMAP 

Since programs can be dynamically loaded and unloaded, the segment table 
kept packed or fragmentation would occur. Thus, the block of ST entries 
program segment begins at an ST entry number that changes if a program w 
loaded before it gets unloaded. To manage this dynamic structure, an au 
structure, the CSTXMAP is used. A program is identified by its index, C 
into this map. The program's current beginning physical ST entry number 
equal to CSTXMAP (CSTXEIX) . 

ENTRY FORMAT-CST EXTENSION BLOCK 



CSTXMAP(CSTXEIX)— > — 

* M = # OF CST'S IN BLOCK • 

1 * VALIDITY=%125252 * 

2 * # OF USERS SHARING BLOCK * 

3 * * 

J301 > * HAS CST ENTRY FORMAT * 

%302 > * HAS CST ENTRY FORMAT * 



%300+M > * HAS CST ENTRY FORMAT * 

COMMENT 

The value of CSTXEIX is established when a CST extension block is alloca 
This index into the array CSTXMAP is maintained in the PCB of each proce 
sharing the block. 
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2.1.9 Flxtd DST Entry Assignments 
OCTAL DECIMAL 



TABLE NAME 









1 
2 
3 

k 

5 
6 

7 
8 

9 

10 

11 
12 
13 

Ik 

15 
16 

17 
18 

19 

20 


CST 

DST 

PCB 

CSTX 

SYS 

CORE 

ICS 

SBUF 

UCRQ 

PPCOM 

IOQ 

TBUF 

LPDT 

LDT 
DLT 
BUSY, 

LST 
TRL 
DDS 




1 


CST 




2 


DST 




3 


PCB 




k 


CSTX 




5 


SYSTEM GLOBAL AREA 




6 


CORE 




7 


ICS 




10 


SYSTEM BUFFERS 




11 


OCOP REQUEST QUEUE 




12 


PROCESS -PROCESS 
COMMUNICATION TABLE 




13 


I/O QUEUE 




111 






TERMINAL BUFFERS 




15 


LOGICAL-PHYSICAL 
DEVICE TABLE 




16 


LOGICAL DEVICE 
AND CLASS TABLE 




17 


DRIVER LINKAGE TABLE 




20 


I/O RESOURCE TABLES 


HEAD, TAIL 


21 


DISC FREE SPACE 




22 


LOADER SEGMENT TABLE 




23 


TIMER REQUEST LIST 




2l» 


DIRECTORY j 


l 
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DST ALLOCATION (COKT.) 







21 
22 

23 
2k 

25 
26 

27 
28 

29 
30 
31 
32 
33 
3U 
35 
36 
37 
38 
39 

1*0 

Ul 
U2 
U3 




25 


DIRECTORY SPACE 




26 


RIN TABLE 


RIN 


27 


SWAPTABLE 


SWAPTAB 


30 


JOB PROCESS COUNT 


JPCNT 


31 


JOB MASTER TABLE 


JMAT 


32 


TAPE LABEL 
TABLE 


VDD 


33 


LOG TABLE 


LOGTAB 


3U 


REPLY INFORMATION 
TABLE 


RIT 


35 


VOLUME TABLE 


VTAB 


36 


BREAKPOINT TABLE 


STOP 


37 


LOG BUFFER1 




Uo 


LOG BUFFER2 




Ul 


• LOG ID TABLE 


LIDTAB 


U2 


ASSOCIATE TABLE 




U3 


CST BLOCK 


CSTBLK 


UU 


JOB CUTOFF TABLE 


JCUT 


U5 


SYSTEM JIT 


SJIT 


U6 


| SPECIAL REQ TABLE 


SRTTAB 


U7 


| VIRTUAL DISC SPACE 
I MANAGEMENT TABLE 


VDSMTAB 


50 


| ////////////////////// 




51 


ARSBM TABLE 


ARSBMTAB 


52 


I ILT 


ILT 


53 


| SIR TABLE 


SIR 
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DST ALLOCATION (CONT, ) 







U5 
k6 

U7 
U8 

>»9 
50 

51 
52 
53 
5* 

55 
56 
57 
58 

59 
60 




5U 


FMAVT 


FMAVT 


55 


INPUT DEVICE DIRECT 


IDD 


56 


OUTPUT DEVICE DIRECT 


ODD 


57 


WELCOME MESSAGE #1 


LOGONDSTN1 


60 


WELCOME MESSAGE #2 


L0GONDSTN2 


61 


CS DATA SEGMENT 


CSTAB 


62 


PROCESS -JOB 
CROSS REFERENCE 


PJXREF 


63 


SYSTEM JDT 


SYS JDT 


61» 


COMMAND LOGON DST 


CILOGDST 


65 


MOUNTED VOL. SET TABLE 


MVTAB 


66 


PRI.VOL. USER TABLE 


PVUSER 


67 


AVAILABLE REGION LIST 


ARLDTAB 


70 


DISC REQUEST TABLE 


DISCREQTAB 


71 


MSG HARBOR TABLE 


MSGHARBTAB 


72 


PRIMARY MESSAGE TABLE 


PRIMMSGTAB 


73 


MEASUREMENT INFO TABLE 


MEASINFOTAB 


7* 


RESERVED 


SECMSGTAB 








75 


FIRST FREE DST 


61 





2-10 



2.2 Swap Tables 
2.2.1 SWAPTAB 



The Swaptab is a core resident memory management table used to ke 
track of the locality lists of the competing processes. 

SWAPTAB DST# = 23 (%27) 

%1025 Sysbase relative index of SWAPTAB entry 0. 



SWAPTAB ENTRY FORMAT 

1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 
|-_|_.|--|.-|--|_-|--|-_|_-|--|-_|_-|__|„|„|-- 

SWAPTABOOl # ENTRIES CONFIGURED 

I - 

SWAPTABOll ENTRY SIZE (5) 



SWAPTAB02| 
I 



# FREE ENTRIES 



SWAPTAB03I TABLE RELATIVE INDEX OF FIRST FREE ENTRY 

I 

SWAPTABOUI 

! 



SWAPTAB UNASSIGNED ENTRY FORMAT 
1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
SWAPTABOOl JlOOOOO 



SWAPTABOll TABLE RELATIVE INDEX OF NEXT FREE ENTRY 

I 

SWAPTAB02I 

I " 

SWAPTAB03I 

I 

SWAPTABOUI 

I- 



An assigned entry in the swaptab is a process' SLL header or a 
member of a process* SLL. These formats are now described. 
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2.2.2 Segment Locality Lists (SLL) 

The system maintains for each process a segment locality list (SL 
the segments belonging to that process' current working set. The 
process' SLL consists of a header and a list of entries. 
The header and list entries are taken from the SWAPTAB. 

A process* SLL is located via the process* pcbentry. PCB01 
contains the sysbase relative index of the process 1 SLL header. 



SWAPTAB 



PCB01-- > 
+— 



+-> 

+ — 



+-> 

+-- 



SLLHEADER 



FIRST SLL ENTRY 



NEXT SLL ENTRY 
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SLL HEADER FORMAT 



1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 



SLLHEADOO 



SLLHEAD01 
SLLHEAD02 
SLLHEAD03 
SLLHEADO^ 



S |S |H |I |P | 


-I--I--I-I--I-I--I--I--I-- 


W |W |A |N |A | 




I |R |S |T |R | 


| IOCNT 


P |E |H |L |T | 




IQ IE |0 |I | 




1 IM |C |N | 





SYSBASE RELATIVE INDEX OF FIRST ENTRY IN LIST 



WORD NOT CURRENTLY USED 
SYSBASE RELATIVE INDEX OF MEMORY REQUEST ENTRY 
# ENTRIES IN PROCESS' SLL 



SLLSCHEDTOIOMS 



SLLFIRSTINX 

SLLMEMREQINX 
SLLCOUNT 



SLLHEADOO .(0:1) SWIP, Swap In Progress Flag 
.(1:1) SWREQ, Swap Required Flag 
.(2:1) HASMEM, Has Memory Flag 
.(3:1) PARTIN, Process partially swapped in 
.(k:h) Available 
.(8:8) IOCNT, Segment read completions until awake 
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SLL LIST ENTRY FORMAT 

1 2 3 *♦ 5 6 7 8 9 10 11 12 13 lU 15 
SLLENTRYOOl PMPQPIN | NMPQPIN JSLLMPQLINK 

! - 1 

SLLENTRYOll SYSBASE RELATIVE INDEX OF NEXT ENTRY IN LIST JSLLNEXTINX 

! i 

SLLENTRY02I SYSBASE RELATIVE INDEX OF PREV ENTRY IN LIST JSLLPREVINX 

! — — - I 

SLLENTRY03I SEGIDENTIFIER |SLLSEGIDENT 

I - I 

SLLENTRYOltl/ |S |/ |/ |/ |/ |/ |T |F |L |S|D|//////////// |SLLFLAGS 
1/ IT 1/ 1/ 1/ 1/ 1/ |0 |Z |K |L| I | //////////// | 
1/ IK 1/ 1/ 1/ 1/ 1/ |S |R |R |L | S| //////////// | 
1/ I 1/ 1/ 1/ 1/ 1/ IS |E |E | I | C | //////////// | 
1/ I 1/ 1/ 1/ 1/ 1/ I IQ IQ |M| I | //////////// | 
1/ I 1/ 1/ 1/ 1/ 1/ I I I Ul0|//////////// | 
I I 

SLLENTRYOO .(0:8) PMPQPIN, previous make present deferred queue pin 
.(8:8) NMPQPIN, next make present deferred queue pin 

SLLENTRY01 .(0:16) SYSBASE, relative index of next entry in list (=0=> 1 

entry) 

SLLENTRY02 .(0:16) SYSBASE relative index of previous entry in list 

(=0«> first entry) 

SLLENTRY03 Has standard segment identifier format. 

SLLENTRYOU .(1:1) STK ==> process" stack entry 
.(7:1) TOSS ==> Toss this entry 

.(8:1) FRZREQ ==> Process requests a freeze on seg 
.(9:1) LKREQ ==> Process requests a lock on seg 
.(10:1) SLLIMI ==> process is queued for this segment 
.(11:1) DISIOSEG ==> process waiting for disc i/o against thi 

seg 
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SPECIAL REQUEST TABLE 



(USED FOR PASSING DATA SEGMENT SIZE CHANGE INFO AND FOR KEEPING 
A LIST OF DEVICES WAITING FOR A SEGMENT TO ARRIVE IN MEMORY.) 



ENTRY 0| # entries in table 

I 

1| entry size (5) 

I 

2 | # available entries 

I 

31 first available entry 

I 

U\ last available entry 



1 = 

first >0| 

assigned | 
entry 1 1 
(pointed | 
to by 
*10l»3) 



21 

I- 
31 

I- 



next assigned entry 
segidentifier 
new data seg size 
read displacement 
move count 
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2.3 Main Memory Region Headers and Trailers 

Main memory is partitioned into regions. Each region is in one of 
three states: available, reserved, or assigned. 

An available region is available for consumption by the free space alloc 
mechanism. An available region consists of neighboring subregions, each 
which is either a hole or an overlay candidate. An available region is 
linked into the available region list of appropriate size. 

A reserved region is a main memory region which is in the transition 
state from available to assigned. A reserved region has been cleaned, 
and there is a pending disc read of a segment into the region. 

Assigned regions are occupied by present segments. Available and re- 
served regions consist of one or more adjacent subregions. Region 
headers and trailers are partitioned into global and local components. 
The global region header/trailer is only valid for the first/last sub- 
region in regions consisting of more than one subregion. 

The region headers and trailers of available, reserved, and assigned 
regions contain the state and control information pertaining to the 
current or planned contents of the region. 
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2.3-1 Available Region Headers and Trailers 



Available Region Global Header Format 
(only valid for first subregion) 



RB-19 



RB-18 

RB-17 

RB-16 

RB-15 
RB-1»» 

RB-13 
RB-12 

RB-11 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 



A |R |A |C |R |R |R |R I //////////////////// |R 

S |E |V |L |E |E |E |E I //////////////////// |E 

S |S | |N |S |S |S |S I //////////////////// |S 

I I ID I I I I I IlliiUllliUIIIIIII | 



REGION SIZE 


(IN MAIN MEMORY PAGES) 


RESERVED 


RESERVED 


REGION BASE OF 
REGION LIST 


PREVIOUS IN THIS AVAILABLE 


REGION BASE OF 
REGION LIST 


NEXT IN THIS AVAILABLE 


RESERVED 



Available Region Subregion Header 
(Valid for All Subregions) 



RAS 



RS 



PLINK 



NLINK 



RB-10 

RB-9 
RB-8 
RB-7 
RB-6 
RB-5 
RB-1* 
RB-3 
RB-2 
RB-1 



1 2 3 *♦ 5 6 7 8 9 10 11 12 13 Ik 15 

-I — I — i— - 1 — I — I - 



I--I--I--I--I--I 

SUBREGION SIZE (IN MAIN MEMORY PAGES) 
V | SUBREGION DISPLACEMENT (IN MAIN MEM PAGES) 



WRITE REQUEST POINTER 
SEGMENT IDENTIFIER 



RESERVED 
RESERVED 



LDEV # | HODA 
LOW ORDER DISC ADDRESS 



/////////////////////////////////////////////// 
/////////////////////////////////////////////// 



SS 

SD 

WREQP 

SEGIDET 



HODA 
LODA 



2-17 



RB =«> 

Available Region Subregion Trailer 



1 2 3 k 5 6 7 8 9 10 11 12 13 lit 15 

iiiiiiiniiiuiiiuiiiiiiiiiimiiiiuiiiiimn 
- — i 

SUBREGION SIZE j TSS 
- I 

Available Region Global Trailer 
(Valid Only for Last Subregion) 

l 2 3 U 5 6 7 8 9 10 11 12 13 l* 15 

I A |R | A I ////////////////////////////////////// | TRAS 
IS |E |V | ////////////////////////////////////// | 

is is i i iiiiiiuiiiiiiiiiiiiiiiiiuiiiiimiii | 

I I 

I REGION SIZE j TRS 

I I 
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2.3-2 Reserved Region Headers and Trailers 

Reserved Region Global Header Format 
(Only Valid for First Subregion) 



RB-19 

RB-18 
RB-17 

RB-16 



RB-15 



RB-ll* 



RB-13 
RB-12 
RB-ll 



1 2 3 *» 5 6 7 8 9 10 11 12 13 1U 15 


|A |R |A |C |S |L |F |I 1 //////////////////// |M | 


IS |E |V |L |C IK |Z |0 | //////////////////// |I | 


IS |S | |N | |D |N |F | UillllimiUUtlll |P | 


1 1 1 ID | 1 | |Z I////////////////////I | 


| REGION SIZE (IN MAIN MEMORY PAGES) | 


I ON-GOING I/O COUNT j 


|M |E |0 |Q |I |E |G |M IRI//////////////////IM | 


|S |X |N |S |N |X |A |S I E | ////////////////// | S | 


|G |T |G |E |C |P |R |G |L|//////////////////|G | 


IP ID |I |G |M |R |B |A I R I ////////////////// 1 V | 


|R |I |0 |R |V |R |C |B |E|//////////////////|A | 


|0 |S |D |E | |E |0 |0 |S|//////////////////|L | 


|C | |I |A | |Q |L |R I P J ////////////////// I I 1 


1 I IS | | | |L |T |G|//////////////////|D | 


I INITIATION MESSAGE INFORMATION | 


im ih ib is u im i/ 1/ i iiiiiiimiiuiiuuu \ 


IS |0 |K |C |0 |S |/ |/ | | 


|G |D |D |B |W |G |/ |/ | | 


IP |R |L |E |A |A 1/ 1/ | | 


|R |E |K |D |I |B |/ |/ | | 


|0 |Q | |M |T |0 |/ |/ | | 


IC I | |S | |R |/ |/ | | 


1 1 1 IG | |T |/ |/ | | 


| PIN OF FIRST PROCESS | PIN OF LAST PROCESS | 


I RELEASE PAGE COUNT | 


I SPECIAL REQUEST TABLE POINTER | 



RAS 

RS 

IOCNT 

INITMSG 



INITINFO 



COMPMSG 



MPQLINK 



PAGECNT 



SPECREQTABPTR 
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Reserved Region Subregion Header 
(Valid for all Subregions) 



1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 



RB-10 


|-.|.-|„|..|,_|..|__|..|..|„j..,..|..,..|..j.. 
SUBREGION SIZE (IN MAIN MEMORY PAGES) 


ss 


RB-9 


c 1 

N | 

T | 

V | # PAGES THIS SUBREGION IS DISPLACED 

A j FROM THE REGION BASE 

L | 

I 1 

D | 


SD 


RB-8 


WRITE REQUEST TO POINTER 


WREQP 


RB-7 


SUBSEGMENT IDENTIFIER 


SEGIDENT 


RB-6 


FREEZE COUNT | LOCK COUNT 


LKFZCNTRS 


RB-5 


WRITE DISABLED COUNT | I/O FROZEN COUNT 


WDIOFZCNT 


RB-U 


LDEV f | HIGH ORDER DA 


HODA 


RB-3 


LOW ORDER DISC ADDRESS 


LODA 


RB-2 


/////////////////////////////////////////////// 




RB-1 


/////////////////////////////////////////////// 





RB "> Firit Word of Segment 

Reserved Region Subregion Trailer 
(Valid for All Subregions) 



1 2 3 1» 5 6 7 8 9 10 11 12 13 1U 15 



IIUIIIHIIIIIIIIIIIIIIUIIHUIIIIIIIIIIIIIIII 



SUBREGION SIZE (IN MAIN MEMORY PAGES) 



TSS 
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Reserved Region Global Trailer 
(Valid Only for Last Subregion) 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

J-I--I--I-I-I---I-I-I--I--I-I-I--I-I-I-I 
|A |R |A I ////////////////////////////////////// | 
IS |E |V | ////////////////////////////////////// | TRAS 
IS IS | I ////////////////////////////////////// | 

I I 

| REGION SIZE (IN MAIN MEMORY PAGES) j TRS 

I " I 
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2.3*3 Assigned Region Headers and trailers 

Assigned Region Global Header Format 
1 2 3 h 5 6 7 8 9 10 11 12 13 lU 15 



RB-19 



RB-18 
RB-17 
RB-16 
RB-15 
RB-lU 
RB-13 
RB-12 
RB-11 



A |R |A |C 

S |E |V |L 

S IS | |N 

I ! ID 

I I I 



I-I--I-I-I--I-I--I-I-I-I 
S |L |F |I | IllliilUIIIIIIUUI | M 

c |k |z |o | IIIIIIIUIIIUIIIIII 1 1 

IP IN |F | IIIUIIUIIIIIIIIIII |P 
I I IZ I //////////////////// | 

I I IN | iiiiiiiiiiiuuimi I 



REGION SIZE (IN MAIN MEMORY PAGES) 
RESERVED 



RESERVED 
RESERVED 



RESERVED 
RESERVED 



RESERVED 
RESERVED 



RAS 



RS 



Assigned Region Subregion Header 



RB-10 

RB-9 

RB-8 

RB-7 

RB-6 

RB-5 

RB-1* 

RB-3 

RB-2 

RB-1 



1 2 3 U 5 6 7 8 9 10 11 12 13 ik 15 

.-I-I-I-I--I--I-I-I-I-I--I--I--I--I-I-- 

SUB-REGION SIZE 



RESERVED 
RESERVED 
SEGMENT IDENTIFIER 
FREEZE COUNT | LOCK COUNT 
WRITE DISABLED COUNT | I/O FROZEN COUNT 
LDEV# | HODA 

LOW ORDER DISC ADDRESS 

iiimiiiiiiiiiuiuiiiuiiiiiiuiiinimmin 

ami i ii minium 1 1 mum iiiiiiniiiiiin 



SS 



SEGIDENT 
LKFZCNTRS 
WDIOFZCNT 
HODA 
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RB==> 

Assigned Region Subregion Trailer Format 



1 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 
„|..|..|--|--|_-|-.|..|__|__|_.|..|..|„|„|„| 

///////////////////////////////////////////////I 
- I 

SUBREGION SIZE | TSS 

1 



1 2 3 * 5 6 7 8 9 10 11 12 13 lU 15 
|„,..|..|._|..|..|._|..|_.|..|..|..|„|..|..|..| 

|A |R | A I ////////////////////////////////////// | TSS 
is IE |v | IllllllllllllilUIIIIUUIIIIIIIllilll | 
IS IS | I ////////////////////////////////////// 1 

I I 

| REGION SIZE (IN MAIN MEMORY PAGES) | TRS 

I-— I 
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2.3.U Region Header and Trailer Field Descriptions 



RAS, 



IOCNT, 



IHITMSG, 



IKITIHFO, 



COMPMSG, 



Region Assignment State 
. (0:1) Region Assigned Flag 
.(1:1) Region Reserved Flag 
.(2:1) Region Available Flag 
.(3:1) Region Cleaned Flag 
. (U:l) Size Change Pending Flag 
.(5:1) Region Locked Flag 
.(6:1) Region Frozen Flag 
.(7:1) Region I/O Frozen Flag 
.(8:7) Available 

.(15:1) Blocked Lock Migration in Progress Flag 
On-Going I/O Count 
= # of on-going I/O's in the region which must complete befo 

initiation message can be processed. 
Initiation Message 

. (0:1) Message Processed Toggle Switch 
.(1:1) Message Externally Disabled Flag 
.(2:1) Message On-going I/O Disabled Flag 
.(3:1) Queue Segment Read Disc Request Flag 
. (U:l) Incore Move Request Flag 
. (5:1) Expansion Request Flag 
.(6:1) Garbage Collection Flag 
.(7:1) Message Aborted Flag 
.(8:1) Release Residual Pages Flag 
.(9:6) Available 
.(15:1) Message Valid Flag 
Initaition Message Auxiliary Information 

= Sysbase relative index of segment read disc request if INI 
QREADREQ=1 
or 

= +/- Displacement to initiation message for moves and expan 
Completion Message 

.(0:1) Message Processed Toggle Switch 

.(1:1) Segment Modification Required 

.(2:1) Block Lock Request 

. (3:1) Send Scheduler A Message 

• (U:l) Awaken A Device 

.(5:1) Message Aborted 

.(6:2) Available 
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MPQLINK, Make Present Deferred Queue Link 

.(0:8) PIN Of First Process Waiting for this Segment 
.(8:8) PIN of Last Process Waiting for this Segment 
PAGECNT, Release Page Count 

=# of extra pages to release before processing initiation 
message . 
SPECREOJTABPTR, points into special request table to the list of 

devices queried on this segment. 
SS, Subregion Size 
SD, Subregion Displacement 

.(0:1) Displacement Count Valid Flag 
.(1:15) f Pages to Base of Region 
WREQP, Write Request Pointer 

= Sysbase Relative Index of Disc Write Request when the 
Data Segment in the Subregion is in Motion Out 
SEGIDENT, Segment Identifier- has standard segment identifier format 
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Space Allocation Structures 



Available regions in main memory are kept track of by multiple free 
All available regions of the same size are linked into to the same 
able region list (ARL). A bitmap is maintained to indicate which 1 
non-empty (ARSBM). A sysglob cell is maintained which contains the 
of the largest currently available region. 

%10U5 MAXAVAILREG, number of pages in largest currently available r 
Available Region List (ARL) 



%1CM SYSBASE index of base of ARL 
ARL DST # = 55 (%67) 



ARLD(O) 



ARLD(l) 



ARLD(2) 



1 2 3 *» 5 6 7 8 9 10 11 12 13 Ik 15 








I--I--I--I--I--I--I 



BANK OF FIRST AVAIL REGION OF SIZE = 1 PAGE 
BASE OF FIRST AVAIL REGION OF SIZE ■ 1 PAGE 



BANK OF FIRST AVAIL REGION OF SIZE 


= 2 


PAGES 


BASE OF FIRST AVAIL REGION OF SIZE 


= 2 


PAGES 



ARLO(N) 



BANK OF FIRST AVAIL REGION OF SIZE = N PAGES | 
BASE OF FIRST AVAIL REGION OF SIZE = N PAGES | 



Where N = maximum available region size 
= (2**l6/2**pagepower) pages 
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Available Region Size Bit Map (ARSBM) 

%100U SYSBASE index of base of ARSBM 
ARSBM DST# = 58 (%7D 



ARSBM(O) 



ARSBM(M) 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

I I I I 1 I I I I I I I I I I I 

I I I I I I I I I I I I I I I I 
I 



I I I I I I 



I I I I I I I I I 



M » (# of available region sizes/16) +1 

ARSBM (J) . (K:l) = 1 ==> the available region list of 

size J*l6+K Pages is non-empty. 
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CHAPTER 3 DISC LAYOUT 



SYSTEM DISC LAYOUT 



SECTOR I 

% o| 

1| 
2 1 
31 
U| 
51 
61 
71 
10 1 
111 



DISC LABEL 



SECTOR # 

|0 



DEFECTIVE TRACKS TABLE 
Cold Load Channel Program for /30, /33, A 1 * 
Hem Dump Channel Program for /30, /33» A 1 * 



CODE FOR 
INITIAL PROGRAMS 
"BOOTSTRAP" 
SEGMENT 



LOW CORE (CST POINTER, QI, ZI, POINTER) 
TEMPORARY CST (INITIAL PROGRAM) 



INTERNAL INTERRUPT HALTS 
BOOTSTRAP STACK 
REMAINDER OF SIO COLD LOAD PROGRAM 



1 

2 

3 

U \ 

5 

6 



> Variable 
Length 



/ 

<--| Follows 

i immediately 

j after 

| Bootstrap 

| Segment 
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SYSTEM DISC LAYOUT (CONT. ) 



SECTOR # 
% 



3U 
35 
36 



75 



I SECTOR # 



DISC COLD LOAD INFORMATION TABLE 



DISC COLD LOAD INFORMATION TABLE 



DISC FREE SPACE TABLE 



128 



129 
130 



1 61 
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SYSTEM DISC LAYOUT (CONT. ) 



SYSDB 



JH30/131 



SYSTEM DIRECTORY 



VIRTUAL MEMORY AREA 



INITIAL PRO GRAM SEGMENTS 
(EXCEPT BOOTSTRAP SEG) 



SYSTEM FILES 
(FROM COLD LOAD TAPE) 



SYSTEM TABLES 

* LPDT 

* LDT 

* VOLUME TABLE 

* DEVICE CLASS TABLE 
INITIAL PROGRAM STACK 



USER FILES 



■-> Note: Initial 
tries to allocate 
directly after 
the Free Space 
Table. However, 
this may vary 
depending on 
deleted or 
reassigned tracks 
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DISC LABEL (Sector of disc) 



SYSTEM VOLUME 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

0| CONTROL ORDER |0 

I I 

II «CYL/ARC #» 11 

I I 

21 



I 



READ ORDER 

<<MEM ADDRESS>> 

SIO JUMP ORDER 

51 «MEM ADDRESS» 
I 

6 1 II I II I III II I II I II | DISK TYPE 



I 



13 

I 

\k 

I 

15 



71 

I 

101 



111 

I 
121 

I 
131 

I 
1U| 

I 
151 

I- 
161 



COLD LOAD ID 



(■All 

ll — #l 



VOLUME NAME 



|DISKSUBTTPE|6 

I 

17 
I 

)" |8 

I 

19 
• I 

lio 



Hi 



112 



"0" 



113 



DISC BOOTSTRAP 
SIO PROGRAM 
(SYSTEM DISC 
ONLY) 

Words 0-5 contain the 
Ascii string 
"SYSTEM DISC " for 
/33, M 



UNUSED 



2U| 

I 

251 

I- 



26| 

I 

271 



CYL 



HEAD 



SECTOR 



ICF WCS 

IMAGE 
POINTER 



RESERVED 



3-U 



122| 

I 

1231 CYL 

I 

12U| HEAD | SECTOR 



3-5 



DISC LABEL SECTOR (CONT.) 



SERIAL VOLUME 



o| 

1 
11 

1 

21 
1 

31 
i 

k\ 
1 

51 


(:STORE) | 

or j 

SIO PROGRAM (:SYSDUMP) | 

For /33» /UU Cold load channel | 
program is in sector 2, and memory dump j 
channel program is in sector 3. j 


6|SC|MV|SR| | TYPE 




I SUB-TYPE j 


71 

1 

io| 

1 
HI 







I 
| 


121 


"S" | 




"E" | 


131 


"R" | 




"D" | 


1U| 


"I" | 




"S" | 


151 


"c I 




it il ■ 


16 i 

• 

2UJ 


SERIAL DISC INFO 






251 


CYL 






26| 


HEAD | 


SECTOR j 


271 

• 

122 1 


RESERVED FOR FUTURE 


WCS 




1231 


CYL 






12U| 


HEAD | 


SECTOR j 





1 

2 
3 
k 

5 
6 

7 
8 

9 

10 \ 
11 
12 
13 / 



VOL NAME 
"SERDISC 



lU ICF WCS 

IMAGE 
15 POINTER 
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DISC LABEL (cent) 



SECTOR 



MASTER VOLUME 



01 |0 

II |1 

21 |2 

?! l3 

5I_ 15 

SC = SCRATCH 6|SC|MV|SR| |6 TYPE 11|12 SUB-TYPE 15|6 

VOLUME - 

MV * MASTER 71 GENERATION INDEX \f 
VOLUME = 1 

SR = SERIAL 10| |8 

VOLUME 11| |9 

— — — -^ 

131 VOLUME jll 

1U| NAME |12 

151 |13 

16 1 INITIAL DATE |ll» 

171 DIRBASE |15 o IF NOT 

■"""■••"■""■""■•••"• — *• — — — — — — — — — — — -""••■-••» — — — —• — — ••»•»«••■■ MASTER 

20 | DIRSIZE | 16 VOLUME 

21| Il7 

22 | ACCOUNT jl8 

231 NAME |19 

2 1 *! 120 



251 
26| 

271 
30 1 



GROUP 
NAME 



121 

1 22 

1 23 
\2k 
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MASTER VOLUME (CONT.) 



311 
32| 
331 
3U| 



VOLUME SET 
NAME 



VS VTAB 
HEADER + 
8 ENTRIES 
COPIED FROM - 
VSET DEFN 37| 
IN SYSTEM U0| 
DIRECTORY kl | 
1»2| 



351 

36 1 VCOUNT 31 



VMASK 



VOLUME 
NAME 



1*31 

UU| SUB-TYPE 

I 

m 

I 

1161 



VTABX 



125 

126 

| 27 HEADER 

128 



129 
130 



131 

132 

133 VOLUME 

13^ ENTRY 



135 

136 



137 

I 



ITS 



VOLUME 

ENTRY 

7 
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DISC LABEL (cont) 



SECTOR 



SLAVE VOLUME 

0| |0 

II II 

2| |2 

31 13 

M I 

SC = SCRATCH 31 I 

VOLUME — — 

MV = MASTER 6|SC|MV|SR| \6 TYPE 11|12 SUB-TYPE 15 1 6 

VOLUME = -- - 

SR = SERIAL 7| GENERATION INDEX |7 

VOLUME - - 

10| |8 

111 19 

12| 110 

131 VOLUME 111 

lk\ NAME |12 

151 U3 

16 | INITIAL DATE \lk 

171 |15 

20| I 16 

21| |17 

22 j ACCOUNT |l8 

231 NAME |19 

2U| |20 

251 1 21 

26| GROUP |22 

271 NAME |23 

30| |2U 

3H 1 25 

32 | VOLUME SET | 26 

331 NAME 1 27 

3k\ |28 
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DEFECTIVE TRACKS TABLE (Sector 1 of Disc) 



1 2 3 U 5 67 8 9 10 11 12 13 1U 15 



II 



31 

I 
U| 

I 
51 

I 
61 

I 
71 

I 
101 

I 
111 



121 



• I 

• I 

• I 



165 
166 
167 



IH--I--I--I--I--I--I--I--I--I--I 
# OF DEFECTIVE TRACK EN1RIES (N) 



DEFECTIVE TRACK NUMBER 



DEFECTIVE TRACK NUMBER 



DEFECTIVE TRACK NUMB8R 
DEFECTIVE TRACK NUMBER 



I DTC 



I DTC 



DTC 
DTC 



3 
1» 

5 
6 
7 
8 

9 
10 



DEFECTIVE TRACK NUMBER 


I DTC 


DEFECTIVE TRACK NUMBER 


| DTC 


DEFECTIVE TRACK NUMBER 


| DTC 



117 
118 
119 



120 DEFECTIVE 
TRACKS MAXIMUM 
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DEFECTIVE TRACKS TABLE (CONT. ) 



170 j DEFECTIVE TRACK NUMBER | DTC 1 120 

I I 

1711 H21 

i ! 

172| 1122 

j RESERVED FOR I 

173| FUTURE USE |123 

I I , 

17U| U2U 

I I 

1751 H25 

I - I 

176| NEXT AVAILABLE ALTERNATE TRACK |126 

I — - "I 

1771 LOGICAL DISC PACK SIZE (CYLINDERS) |127 

I " " I 

OR # OF TRACKS IF FH DISC 



DTC 


(DEFECTIVE TRACK CODE) 





suspect 


1 


suspect alternate 


2 


deleted 


3 


reassigned 



NOTE: The situation where there are two entries for the same 
track, n, one having a DTC of (suspect) and the other having 
a DTC 3 (reassigned) results from a situation where the disc 
driver could not "read" (unreadable) the address of the 
particular track. 



•5_1-| 
J-XJ. 



DISC COLD LOAD INFORMATION TABLE (SECTORS 28-29) 



01 
I 



I 
10 1 

I- 
HI 

I- 
12 1 

I 
131 

I- 
lk\ 

I 
151 



161 



171 

I 

181 

I 
191 



201 



I 



pointer to table information 



!| pointer to temporary CST info 

2 1 # of entries to read on disc cold load 



31 # of code segments in INITIAL 

i»l INITIAL'S DB value 

I 

51 
| 

61 

I— — - 
71 
I ■ 

81 



INITIAL'S DL value 
INITIAL'S Z value 



INITIAL'S Q value 
INITIAL'S S value 



I SYSDISC type | subtype 
cold load ID 



log file number 
directory disc 
address 



ldev 1 virtual memory 
disc address 



# LOG PROCS 
LOG ID's 



RIN table 
disc address 



directory size 



21 1 Isectors in virtual memory region of LDEV 1 



22 



231 

I 
2U| 



UNUSED 
RIN table size 
# of RINS 



FAEFTR >- 

TCSTPTR 

NREAD 

NVTCST' 

INITDB 

INITDL 

INITZ 

INITQ 

INITS 

DISCTST 

COLD' LOAD 'ID' 

LOG' FILE 'NUM' 

DIRADR 
VTRIffiMADDR 



RINADR 

DIRSECT 

SECTORS IN LDEV1 VM 

RINSECT 

RINS 
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DISC COLD LOAD INFORMATION TABLE (CONT.) 

I " - 

251 # of global RINS 

I 

26| |TL|RL|RY 

I " 

I 
27| HIGHEST VOL # | # OF VOLUMES 

I " 

28 | disc cold load entry point 

I " 

29 1 system disc DRT number 

I " 

30 1 Job Master Table 

I 
31 1 Disc Address 

I— - 

32| 

| IDD Disc Address 

331 

I " 

3M 

| ODD Disc Address 

351 

36 1 Welcome Message (DST U7 

I 10) 

37| Disc Address 

38| Welcome Message (DST U8 

| 10) 

39| Disc Address 

I 

uo| 

I LOG ID ADDRESS 
Ml 

I 

U2| 

I LOG TAB ADDRESS 

U3I 

I 

UUJ LOG ID SIZE 

! - - 

U5 j LOG TAB SIZE 

I — " 

j SIZE IN WORDS 

| --- "DRIVER 

| MEMORY ADDRESS 

j - — TABLE 

I 

| DISC ADDRESS 

I 

I " 
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GRINS 
TL=Tape cold load 
LOAD MODE 

RL=Reload 

RY=recovery 
H'VOL' 

DISCENTRY 

SYSDISCDRT 

JMATLOC 



IDDLOC 



ODDLOC 



LOGONLOC1 



LOGONLOC2 



FAEFTR+0 <• 



DISC COLD LOAD INFORMATION TABLE (CONT. ) 







S SIZE IN WORDS | 


1 MEMORY ADDRESS 


*CTABO | 


! DISC ADDRESS | 


1 SIZE IN WORDS | 


! MEMORY ADDRESS 


*CTAB 1 


1 DISC ADDRESS | 


1 SIZE IN WORDS 


• 1 


1 MEMORY ADDRESS 


TION SUB- I 


1 DISC ADDRESS 


DRIVER | 
TABLE | 


i SIZE IN WORDS 


* i 


1 MEMORY ADDRESS 


J.i.Mfi SUB 1 ™ 1 I 


1 DISC ADDRESS 


DEFINITION) 
TABLE j 


1 SIZE IN WORDS | 


1 MEMORY ADDRESS 


SUBSYSTEM j 


i DISC ADDRESS 




I SIZE IN WORDS J 


1 MEMORY ADDRESS 


PHYSICAL | 


j DISC ADDRESS 


TABLE j 







FAEFTR+l* 



FAEFTR+8 



FAEFTR+12 



FAEFTR+16 



FAEFTR+20 



FAEFTR+2U 



3-lU 



SIZE IN WORDS 

- LOGICAL 

MEMORY ADDRESS DEVICE 
TABLE 

DISC ADDRESS 

SIZE IN WORDS 
DEVICE 

MEMORY ADDRESS CLASS 
TABLE 

DISC ADDRESS 



FAEFTR+28 



FAEFTR+32 
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DISC COLD LOAD INFORMATION TABLE (CONT. ) 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



SIZE IN WORDS 
MEMORY ADDRESS 



DISC ADDRESS 



STACK SIZE 



MEMORY ADDRESS 



DISC ADDRESS 



SEGMENT SIZE 



MEMORY ADDRESS 



DISC ADDRESS 



VOLUME 
TABLE 



LOGICAL 

DEVICE 

TABLE 



INITIAL'S 
STACK 



INITIAL'S 
SEGMENTS 



FAEFTR+36 



FAEFTR+UO 



FAEFTR+UU 



TCSTFTR 



(MORE SEGMENTS OF INITIAL) 
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INITIAL PROGRAM CS7 MAP 



LOGICAL 


PHYSICAL 






CSTf 


CST# 
37 


SEGMENT NAME 




17 


BOOTSTRAP | 




16 


36 


RESIDENT | 


-> core resident 


15 


35 


MAINSEG1 \ 




Ik 


3U 


CONFIGURE | 


| non-core resident 


13 


33 


DEFCTRACKSJ 


|but present in core 


12 


32 


SETUP | 


— |at completion of 


11 


31 


FILEIO | 


|cold load 


10 


30 


DISKSPACE | 




7 


27 


DIRECTORYlj 




6 


26 


DIRECTORY2/ 




5 


25 


SL PROGRAM 




U 


2U 


PROCESS 




3 


23 


MAINSEG1B 




2 


22 


MAINSEG2 




1 


21 


MAINSEG3 







20 


MAINSEGU 





•code segment swapping starts at completion of MAINSEG1 
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Virtual Disc Space Management Structures 

Disc space for data segments is allocated from reserved regions of system 
volumes which have been assigned the virtual memory supporting (VMS) attribute. 
The data structure used for accounting and management of the virtual disc 
space of the various VMS volumes is the Virtual Disc Space Management Table 
(VDSMTAB). This structure consists of a circular list of entries, one for each 
VMS volume. Each entry contains the information defining the state of the 
virtual memory region on that volume. 



Virtual Disc Space Management Table 

VDSMTAB DST# » 39 (%kj) 
VDSMTABPTR= $1026 



General Structure 



%1026 




# VMS 
first 


! Volumes 
to look 


at| 


Next 


in list 




Next 


in list 




Next 


in list 





<-+ 
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VDSMTAB Entry Format 



VDSMTABOO 
VDSMTAB01 
VDSMTAB02 
VDSMTAB03 
VDSMTABOU 
VDSMTAB05 
VDSMTAB06 
VDSMTAB07 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



#WORDS IN VDSMT 



# SYSTEM VOLUMES WHIC3I HAVE VIRTUAL MEMORY 
INDEX OF NEXT ENTRY TO ALLOCATE FROM 



VM PAGE SIZE (512) 
# SECTORS/VM PAGE (U) 



OFFSET FROM ENTRY TO BITMAP (%20) 
TOTAL # VM PAGES CONFIGURED IN SYSTEM 
LEAST # OF VM PAGES THAT HAVE EVER BEEN AVAIL. 



VDSMTAB %10-%17 UNASSIGNED 



TABLELENGTH 

VMSVOLUMECNT 

STARTENTRY 

VMPAGESIZE 

SECTORSPERVMPAGE 

OFFSETTOBM 
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Word 
Word 1 
Word 2 
Word 3 
Word U 
Word 5 
Word 6 
Word 7 
Word JtlO 
Word %11 
WORD %12 
%13-%20 



VDSMTAB GENERAL ENTRY FORMAT 

1 2 3 ** 5 6 7 8 9 10 11 12 13 lU 15 
._|__|._|._|„|-|~|--|--|"|--|"l"l--|--|- 



INDEX OF NEXT ENTRY IN CIRCULAR LIST 
LDEV# 



STARTING SECTOR OF DEVICE'S 
VIRTUAL MEMORY REGION 



# SECTORS IN DEVICE'S 
VIRTUAL MEMORY REGION 



I PAGES IN DEVICE'S VIRTUAL MEMORY REGION 
# OF PAGES AVAILABLE IN DEVICE'S VM REGION 



# OF VALID WORDS IN DEVICE'S BIT MAP 
SIZE OF SMALLEST RECENT MISS 



SMALLEST NUMBER OF PAGES EVER AVAILABLE 
UNASSIGNED 



DEVICE'S VIRTUAL MEMORY BIT MAP 

I I I I I I I I I I I I I I 

I I I I I I I I I I I I I I 



NEXTINLIST 
LDEV 

HOSTARTSECTOR 
LOSTARTSECTOR 
TOTAL SECTOR 
COUNT 

TOTAL PAGECNT 
PAGESAVAILABLE 
BMLENGTH 
SMALLESTMISS 



* # *COMMENT: A bit on in a device's VMBIT MAP 
==> Corresponding VM page is free. 
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DISK FREE SPACE TABLE 



There is one disc-free-space table for each disc in the system. The 
table begins at sector #30(10) and its size is specified within the 
table itself. The table is read one page at a time, as needed, into an 
extra data segment (DST #17(10)). A page consists of one or more 
sectors and is currently equal to 2 sectors. The table is kept packed 
at all times and disc addresses are in ascending order. Any two entries 
represent two disjoint areas on the disc. 

DISCSPC can be called to: 



3. 



Fetch a specified size at any location. If the space allocated 
corresponds exactly to one table entry, the entry is deleted 
and the table collapsed. 

Fetch a specified size at a particular location. If the location 
is in the middle of a free area, an additional table entry is 
created and the table expanded. If the location abuts either end 
of a free area, the table size is unchanged; if it abuts both 
ends, the table is collapsed as above. 

Return a specified size at a particular place. The table will 
be expanded if the returned space does not abut free space. 



format of page #1 



format of succeeding pages 



HEADER 

ENTRY#1 
ENTRY#2 



ENTRY#n 



ENTRY#(n+l) 



ENTRY#62(10) 



ENTRY#(n+63) 
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DISC FREE SPACE TABLE (CONT. ) 



HEADER FORMAT (8 WORDS) 



word 
index 



I 



11 
I 

21 
I 

31 
I 

I 
51 



IENTRIES IN TABLE 
TABLE SIZE (SECTORS) 



LOWER BOUND 

FOR FREE SPACE 

(SECTOR*) 



UPPER BOUND 

FOR FREE SPACE 

( SECTOR* ) 



doubleword 
index 



I////////////////////// 



61 



MIIIIUIIIIIIUIIIIIII 



71 



1 HIN 



2 MAX 



MIN & MAX are disc addresses indicating the minimum and maximum disc 
addresses accountable by DISCSPC (i.e. no space which goes outside 
these bounds may be requested or returned). 



ENTRY FORMAT (U WORDS/ENTRY) 



word 
index 



I 
01 



| SECTOR NUMBER WHERE 



1! 
I 



SPACE STARTS 



fSECTORS AVAILABLE 



doubleword 
index 
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VOLUME TABLE 



SIR #22=%26 
DST #29=%35 



zero entry 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
woz>d| — I--I--1 — I--1--I--1--1--I--I--1 — I--I — 1--1 — I 
I # OF ENTRIES | I 

0| (NOT COUNTING ZERO) | ENTRY SIZE=l6(8) jo 

I " ~~———| 

1| COLD LOAD ID |1 

I - I- 

2 1 SYSVOLNUM | 

I - " I- 

3| VIRTUAL MEMORY INTEGRITY NUMBER | 

I- - I 



I " — "I 

15 1 /////////////////////////////////////////////// 1 13 
I— I 
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TYPICAL PRIVATE VOLUME ENTRY 



01 

I 
II 

I 
21 

I 
31 

I 
Ul 

I 
51 

I 
61 

I 
71 



101 



111 



121 

I 

131 



151 



VOLUME 
NAME 



GROUP 
NAME 



ACCOUNT 
NAME 



I LOGICAL DEVICE # | 
1U| («0 IF NOT MOUNTED) | 



!VMS|UN|NS|SC 



IVSET VTABX | 
I I 



MVTABX 




1 
2 
3 
U 

5 
6 

7 
8 

9 

10 

11 



indexed by 
volume # 



NS - NON-SYSTEM 

DOMAIN 
SC - SCRATCH 
UN - UNREADABLE/ 

UNFORMATTED 
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TYPICAL SYSTEM VOLUME ENTRY 



0| 
1| 
2 1 
31 
U I 

51 
61 
71 
10 1 
111 
12 1 
131 

12*1 

151 



VOLUME 
NAME 



STARTING SECTOR OF VOLUME'S VM (0 if none) 



NUMBER OF SECTORS RESERVED FOR VM ON VOLUME 
(0 if none) 



LOGICAL DEVICE # | 
(=0 IF NOT MOUNTED) | 



|VMS|UN|NS|SC 
I I I I 



iVSET VTABX 



MVTABX 





1 
2 

3 
U 

5 
6 

7 
8 

9 
10 

11 



indexed by 
volume # 



NS - NON-SYSTEM 

DOMAIN 
SC - SCRATCH 
UN - UNREADABLE/ 

UNFORMATTED 
VMS - VIRTUAL MEMORY 

SUPPORTING 
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CHAPTER k DIRECTORY 



DIRECTORY 

Directory on disc consists of a contiguous area 
SYSGLOB cells: 

DIRBASE< -absolute disk addr of base [SYSGLOB+%130 AND %13l] 

DIRBASE > | - I 

---I LASTWORD | 

I " "I 

| FIRSTAVAIL |-- 
(WORD ADDR) j |— I | POINTS TO NEXT WORD TO BE EXAMINED 

I M 

| BITMAP < 

(DIRECTORY ~ The bitmap defines the available/ 

>| SECTORS USED) | used sectors in the directory. Bit 

j j 0, word corresponds to DIRBASE; 

| j bit 1 to DIRBASE+l;etc. 1=> avail- 

| I able 0=> used. [Note: BITMAP (0). 

j j (0:U)=0 always.] 



DIRBASE+3 > 



DIRECTORY 



I 



Directory entries contain pointers 
which are sector displacements 
relative to DIRBASE. Entries and 
indices are grouped into "blocks" 
(block = 3 sectors). 



The capacities for accounts /groups /users/files are dependent on their 
block sizes, described in the directory data segment. 



* SYSSAIBSIZE 
SYSAUIBSIZE 
SYSAGIBSIZE 
SYSGFIBSIZE 
SYSGVSIBSIZE 

* SYSAEBSIZE 
SYSUEBSIZE 
SYSGEBSIZE 
SYSFEBSIZE 
SYSMAXBSIZE 
SYSVSEBSIZE 



System acct index block size (sectors) 

Acct. user index block size (sectors) 

Acct. group index block size (sectors) 

Group file index block size (sectors) 

Group volume set definition ind. blk. size(sectors) 

Acct. entry block size (sectors) 

User entry block size (sectors) 

Group entry block size (sectors) 

File entry block size (sectors) 

Maximum of above, (used to initialize DDS.) 

Volume set definition entry block size (sectors) 



*These values are used once for the creation of the (root) system, 
account index or new systems. This root index is always at address 
DIRBASE+3- 



U-l 



OVERVIEW OF DIRECTORY 



OVERVIEW OF DIRECTORY 



ACCOUNTS 



KEY: 



INDEX 



SYSTEM 



/ / \ \ 
/ / \ \ 
/ / \ \ . . . 



I I I 
/ 



/ 
/ 
/ 

| USERS | 

/ / \ 
/ / \ 



I I I I 
I I I I 



I GROUPS | 

/ \ \ 
/ \ \ 

I I I I I I 



| GROUPS 



USERS 



/ \ 

/ \ 

/ \ 

/ \ 



I VSETS | | FILES | 



/ 



I 

VSETS/ | | 
VCLASSES | | 



/ / \ 

/ / \ 

/ / \ 



I I I 



ENTRY 



I I I I 
/ 



| FILE 

I POINTERS 



/ 

FILE 



/ 



l*-2 



DIRECTORY DATA SEGMENT 



o 1 

• 
* 

177 1 






« 
« 

127 
128 
129 
130 
131 
132 
133 
13U 

135 
136 
137 
138 

* 139-3 
' 161-3 

183 

18U 

185 

186 

187 

| 188 

1 189 

1 190 

1 191 


DST=20(10) 
SIR=8(10) 


SECTOR j 
BUFFER 
128(10) WORDS 


200 | 


ADJUST (DB-DL) j 




201 | 


XTYFE (INPUT PARM) 




202 | 


: XMVTABX | 




203 1 


XINDEXP (FINAL INDEX PRT) 




20U | 


XANAME (DB REL ADDR) 




205 1 


XGUNAME (DB REL ADDR) | 




206 


XFNAME (DB REL ADDR) 




207 1 


XASEC (ACCOUNT SECURITY) 1 




210 
211 


-XGSEC (GROUP SECURITY) - 


< 


212 


SIRRETURN (FROM GETSIR) 




213-2U0 " 


' DIRECTORY POINTER "A" 


.60 \ 

> SEE Directory 
.82 / Pointer Area 


2U1-266 ' 


' DIRECTORY POINTER "B" 


267 


////////////////////////// 




270 


LDEV : DIRECTORY 




271 


BASE DISC ADDRESS 




BSIZE=3 


SYS. ACCT. INDEX BLK SIZE 




AUI=1 


i ACCT. USER INDEX BLK SIZE 


- 


AGI=1 


| ACCT.GRP INDEX BLK SIZE 




GFI=2 


| GRP FILE INDEX BLK SIZE 




GVSI=1 


|GRP VOL DEF INDEX BLK SIZE 




AEB=3 


| ACCT ENTRY BLK SIZE 
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DIRECTORY DATA SEGMENT (CONT.) 









UEB=2 


i USER ENTRY BLK SIZE | 


192 


GEB=2 


I GRP ENTRY BLK SIZE | 


193 


FEB=2 


I FILE ENTRY BLK SIZE | 


19U 


VSEB=1 


1 VOL DEF ENTRY BLK SIZE [ 


195 


DDSBSIZE=3 


I MAX. SIZE DIRECTORY BLOCK | 


196 


DDSBWSIZE =%600 


I DDSBSIZE # 128 | 


197 


GOODPERCENT= . 85 
307 


1 DISTRIBUTION | 
1 FACTOR | 


198 
199 


310 


! BASE | 


200 


311 


DA AREA 


201 
DDSBWSIZE 










WORK AREA f 
(SIZE OF LARGEST ENTRY) 


MAX 




m 




lll»5 


DB AREA 


613 
DDSBWSIZE 



k-k 



** 



DIRECTORY POINTER AREA [DA OR DB] 

138/ 



LDEV | DIRECTORY BASE 
ADDRESS OF PAGE IN BUFFER 
DIRECTORY PAGE IN BUFFER 
DB ADDRESS OF 1ST ELEMENT 
STARTING ADDRESS OF BUFFER 

# VALID PAGES IN BUFFER 
DIRTY FLAG 

ELEMENT SIZE 

# WORDS USED IN BLOCK 
BLOCK SIZE (SECTORS) 



BLOCK SIZE (WORDS) 



MAX # ELEMENTS /BLOCK 



-l-l-l-l 1 

I|P| TYIELEMENT SIZE|BLOCK SIZE 

| | | | (WORDS) | (SECTORS) 

-l-l-l-l I "- 



NUMBER OF ELEMENTS 



NUMBER OF ACCESSORS 



ENTRY TOTAL 



l-l 



0|P| TYIENTRY SIZE| BLOCK SIZE 
-l-l-l-l (WORDS) J (SECTORS) 
-l-l-l-l I • 



FATHER INDEX POINTER 
F 



H- 

E 
- --R-- 



N 

A 

M 
E- 



DST=20(10) 
SIR=8(10) 



160 DIRBASE1' 



139/ 

] 

1U0/ 

lUl/ 
3 

1U2/ 
3 

11*3/ 
3 

1UU/ 



161 DIRBASE2" 



1U5/ 
3 

1U6/ 
3 

1U7/ 



162 CONTENTS 
I 

163 LPNTR 
I 

16U IOPNTR 

163 NUMVALID 
I 
166 DIRTY 



NOTE: 



167 XSIZE 



168 USED 



1U8/ 
3 

1*9/ 

3 

150/ 



169 BSIZE 
f 

170 BWSIZE 



** INDEXES AND 
ENTRIES 

* INDEXES ONLY 



171 BFACTOR 



172 MISCWD 



151/ 
3 

152/ 
3 

153/ 
3 

15U/ 



173 XCOUNT 

f 
nk PCOUNT 

I 

175 ETOTAL 
I 

176 EMISCWD 



155/ 

3 

156/ 

3 

157/ 
3 

158/ 
3 

159/ 



177 PINDEXP 
I 

178 
I 

179 PNAME 
f 

180 



181 



TY = 0-FILE 

1 -GROUP 

2-ACCT 

3 -USER 

U-VSD 
I = -ENTRY BLOCK 

1- INDEX BLOCK 
P = PURGE FLAG 



U-5 



DIRECTORY SPACE DATA SEGMENT (DIRSDS) 



DST=21 



10 



SIR=8 



10 



LDEV | 
DIRBASE 



LASTWORD 
FIRSTAVAIL 



BITMAP < 



base address of parent directory 

defines last word of bit map 
defines next word to be examined 



The bitmap defines the available/used 
sectors in the directory. Bit word 
corresponds to DIRBASE; bit 1 word to 
DIRBASE+1 etc. l=>available 0=>used. 
[NOTE: bitmap(0).(0:U)-0 always.] 
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DIRECTORY STRUCTURE 



ENTRY BLOCK 




ENTRY 
ENTRY 
ENTRY 
ENTRY 
ENTRY 
ENTRY 



U-7 



>PAGE 
>BLOCK 
>INDEX 
>ENTRY 

>POINTER 

>DDS 
>ELEHENT 



DIRECTORY DEFINITIONS 



smallest allocatable record ("phys. reed") -currently sector. 
integral* of pages; contains contiguous indices or entries, 
pointer to entry block, containing name of 1st entry, 
information-containing "object" may contain pointer to an 
index block. 

15-bit positive relative page number (relative to directory 

base) . 

directory data segment. 

a generic name for index or entry. 



INDEX BLOCK PREFIX (10 WORDS) 



0-FILE \ 
1-GR0UP| 3 bits 

2-ACCT |< 

3-USER / 
U-VSET 

PUROE FLAG< 

MISCWD 



•>| INDEX SIZE (WORDS) 
I 7 BITS 



•>| BLOCK SIZE (SECTORS) 
I U BITS 



0|1|P| TY I XSIZE 



IBSIZE 



II 

I 
21 

I- 
31 



I — I 



XCOUNT 
IPCOUNT 



EMISCWD 



ETOTAL 

l-l-l— -I I 

U|0|P| TY I EXSIZE IEBSIZE 

l-l-l— -I I 

51 PINDEXP 

I - 

61 



71 

I 
10| 

I 
HI 

1 = 

I 



PNAME 



INDEX BLOCK INFO. 

1 NUMBER OF INDEX POINTERS 

2 NUMBER OF ACCESSORS* 

3 ENTRY TOTALS 

h ENTRY BLOCK INFO. 

5 INDEX POINTER OF FATHER 

6 \ 

I 

7 I 



8 



>NAME OF FATHER 



9 / 



*The count is incremented by each access that uses and relies 
upon a pointer to the index block, ie, it is guaranteed not 
to be purged while the count is not = 0. 



k-B 



INDEX ENTRY (6 WORDS) 



IE1STNAME 



|0 1st NAME OF ENTRY BLOCK 

I 

II 

I 

12 

I 
13 



IEPNTR 
IECOUNT 



I 

|U POINTER TO ENTRY BLOCK 

I 

| 5 NUMBER OF ENTRIES IN ENTRY BLOCK 



ACCOUNT ENTRY (%36 WORDS) 



1— 

o| 

1 




|o 




1 

11 

1 

2| 
1 . 


ANAME 


|1 
1 2 


ACCT.NAME 


1 

31 
r 




13 




1 — 

U| 
i 


AGIPNTR 


\k 


ACCT. GROUP INDEX POINTER 


1 — 

51 
i 


AUIPNTR 


15 


ACCT.USER INDEX POINTER 


1 — 
61 

1 

71 
i 


ACAP 


17 


CAPABILITY 


1 — 
10 1 

1 
111 

1 


ALATTR 


18 
19 


LOCAL ATTRIBUTES 


12| 
i 




|10 


PASSWORD 


1 
131 

1 

1U| 
1 


APASS 


1 12 




151 
1 — 




U3 
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GROUP ENTRY (%51 WORDS) 



6| 

71 

10 1 

111 
12| 

131 
ll»| 
151 
161 
171 
20 1 
21 1 
22 1 

231 
2l*| 

251 
261 



GNAME 



GFIPNTR 



GPASS 



GDFSCOUNT 



GDFSLIMIT 



GCPUCOUNT 



GCPULIMIT 



GCONTIMECOUNT 



GCOhrlhtLIMIx 



>P| 



GSEC 



GROUP NAME 

1 

2 

3 

k GROUP FILE INDEX POINTER 

5 

6 PASSWORD 

7 

8 

9 DISC FILE SPACE COUNT (SECTORS) 

10 

11 DISC FILE SPACE LIMIT (SECTORS) 

12 

13 CPU TIME COUNT (SECONDS) 

1U 

15 CPU TIME LIMIT (SECONDS) 
16 

17 CONNECT TIME COUNT (MINUTES) 
18 

19 CONNECT TIME LIMIT (MINUTTS) 
20 

21 GROUP SECURITY (SEE BELOW) 
*P = PURGE FLAG 



U-ll 



GROUP IfmY (CCHT.) 



27 
30 
31 
32 
33 
3U 
35 
36 
37 
U0 
Ul 
U2 

U3 

kk 

U5 
U6 
U7 
50 



GCAPABILITY 
GLINKAGE 



GVSDIPNTR 
GHVSNAME 

GHVSANAME 



GHVSGNAME 



GHVSVSNAME 



GSAVEFIPNTR 



123 

I 
2U 

I 

!25 



I 



GROUP CAPABILITY 
GROUP DIR. BASE LINKAGE 
GROUP VOL SET DEFN INDX 
HOME VOL SET NAME 



126 

I 

|27 

I 

1 28 (Definition's acct name) 



-I 



j (Definition's group name) 



129 

I 

130 

I 

131 

I 

132 

I 

133 
I 

I3U 
■I 

135 
| (Definition's vol set name) 



-I 



136 

I 

137 

I 
138 



GMOUNTREFCNTR | 39 

I 

|U0 



SAVE CELL FOR GFIPNTR 
GROUP BIND COUNTER 
GSPARE 



i»-12 



GROUP ENTRY (CONT. ) 



GLINKAGE (0:1) = 0; System Domain 

(0:1) = 1; Private Volumes 

(8:8) = 0; Not Bound 

(8:8) <>0; Bound 



GROUP SECURITY MASK 



I — I — I — I 



— I — 
W | W 
ANY J AC 



I P I///I R | R | R 
251 |///|ANY|AC |AL 

I — I — I — I — I — 
I W | L | L | L | L 
26|GL |ANY|AC |AL |GU 

| — | — I — I — I — 



R 
GU 



R | A | A 
GL |ANY|AC 



A 
AL 



A | A 
GU IGL 



W 

IAL 



W 
IGU 



... I — 
S | s 
AC IAL 



L 
GL 



X | X I X 
ANYlAC IAL 



X 
GU 



X | S 

GL |ANY 
— I — 



S 
IGU 



S 

IGL 



I 
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FILE ENTRY (FILE POINTER) (6 WORDS) 



FNAME 



FVTABINX | 

FLABELADDR 



|0 FILE NAME 
i 



12 



|U VOL TABLE INDX /FILE LABEL DISC 

| ADDRESS 

15 

I 



USER ENTRY (19 WORDS) 








1 
"2 
3 

U 

5 
6 

7 

8 

9 

10 

11 

12 
13 
ilU 

115 
| 3 

116 
H7 
118 




o| 

lj 

2| 
31 


UNAME 


USER NAME 


51 


UCAP 


CAPABILITY 


61 

71 


ULATTR 


LOCAL ATTRIBUTES 


10 1 

111 

12! 

131 


UPASS 


PASSWORD 


1U 

15 
16 

17 


UHGROUP 


HOME GROUP (MAY BE NULL) 

.OG CNT (# OF USERS LOGGED ON) 
INIT TO 1 FOR MANAGER. SYS SO 
THIS USER CANNOT BE PURGED 
MAX. JOB PRI;*P=PURGE FLAG 
U=UDC EXIST FLAG 


20 


ULOGCOUNT 


UMAXJOBW 21 


*P|U 


| JOBPRI 


22 


i 

COMM FILE REC # 
(command file loc of 
user udc's) 



k-lk 



USER ATTRIBUTES/CAPABILITY 



/ 



SAVE FILES 



FILE-ACCESS ATTRIBUTES < 



USER 



ATTR 



\ NON-SHARABLE DEVICES- 
COMMUNICATIONS 



-SYSTEM MGR 
-ACCOUNT MGR 
-ACCOUNT LIBRN 
-GROUP LIBRN 
•DIAGNOSTICIAN 
-SYSTEM SUPVSR 

CREATE VOLS 

| USE VOLS 

I | USER LOGGING 

I i I 

I 



|SM|AM|AL|GL|DI|OP|CVjUV|LG|//|//|//|//|CS|ND|SF| 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
|_.|-.|_-|_-|_-|_-|-_|„|-|-|-|-|-|«|~|--| 

I // 1 // 1 // 1 // 1 // 1 // 1 // 1 BA| IA| PM | // 1 // |MR| // IDS | PH| 

|..|..|..|--|..|..|-_|.-|-.|-j-|-|-|--|"l"l 



/ batch access 
| interactive access 

ACCESS j privileged mode 

TO < 

GENERAL | multiple RINS 

RESOURCES | extra data segment 
\ process handling 



I I I 
I I I 
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VOLUME SET DEFINITION ENTRY 



TY = 



/ 6 

I 7 

VOLUME | 10 

ENTRY < 11 

(6 WORDS) | 

I 12 

\ 13 



VOLUME 
ENTRIES 
1 - 7 



/1U 
I . 



\ 57 
60 
61 
62 
63 
6k 

65 
66 

67 



GVSNAME 



TY|1 

VOL COUNT | U 



71 
71 



MVTABX 
VMASK 



GVSVOLUME 



SUB-TYPE 



VTABX 



GVSVOLUME 



1U| M 



GVSVOLFLAGS 

GVSVOLINFO 

GVSDREFCNT 



(MEMBER VOLUME FLAGS) 
(MEMBER VOLUME INFO) 



(DEFN. REF. CNTR.) 




TY = VOLUME SET 

= 1 VOLUME CLASS 
MVTABX: MOUNTED VOLUME TABLE INDEX (IF MOUNTED) 
VOL COUNT: NO. OF VOLUMES 
VMASK: VOLUME MASK 
M = NOT MOUNTED 

= 1 MOUNTED 
VTABX: VOLUME TABLE INDEX 



1 VOLUME 

2 SET 

3 NAME 

U GVSLINKAGE 

5 GVSINFO 

6 MEMBER VOLUME 

7 NAME (1ST ENTRY 

8 IS MASTER 

9 VOLUME) 

10 GVSVOLFLAGS 

11 GVSVOLINFO 
12 



U7 
U6 

U9 

50 MEM. VOL. 

NAME 
51 

52 
53 

55 SPARE 



** -J.U 



GVSLINKAGE 
l 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 

i ! 

| T | A ! NOT | MVTABX I 

I | J USED | I 

I - — - - - i 

T - TYPE 

1 = Volume Set Definition 

= Volume Set Class 
A - ALLOCATING FLAG 

= not initialally allocating (not 1st user of set) 

1 = 1st user of set allocating resources (transitional) 
MVTABX - Mounted Volume Table Index 

if volume set not logically mounted 

G V S I N F 
1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

i ! 

| VOLCNT | NOT | VSMASK 1 

| J USED I I 



VOLCNT - Number of members in set 
VSMASK - Bit mask of volume member usage 
Order is from right to left 
i.e. bit 15 is 1st member, bit lU is 2nd member ... 

GVSVOLFLAGS 

1 2 3 * 5 6 7 8 9 10 11 12 13 l 1 * 15 

I I 

| NOT USED I M | 

I I I 



M - Member Mounted Flag 

= not mounted 

1 = mounted 

GVSVOLINFO 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

I - " I 

| DISK | VTABX | 

| SUB-TYPE | I 

| | 

VTABX - Volume Table Index 
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VOLUME SET CLASS ENTRY 



111111 
0|1:2:3|U:5:6|7:8:9|0:1:2|3:U:5 



01 

I 
II 

I 
21 

I- 
31 

I- 
M 

I- 
51 

I- 
61 

I- 
71 

I- 
10| 

I- 

111 

I- 
121 

I- 
131 

I- 

lM 



I- 



151 
I- 

161 
I- 

171 
I- 

20 1 

I" 

21 

I- 
22| 

I- 
231 



GVCNAME 



GVCLINKAGE 
GVCIKFO 
GVCPNAME 

GVCPANAHE 



GVCPGHAME 



GVCPVSKAME 










1 
2 
3 
It 
5 
6 
7 
8 

9 
10 
11 
12 
13 
lit 

15 
16 

17 
18 
19 



VOLUME CLASS NAME 



VOLUME CLASS IDENTIFICATION 
VOLUME CLASS INFORMATION 
PARENT VOLUME SET DEFINITION 

ACCOUNT OF PARENT DEFINITION 



GROUP OF PARENT DEFINITION 



VSNAME OF PARENT DEFINITION 



671 



155 



M-I8 



GVCLINKAGE 



8 9 10 11 12 13 lU 15 



I 



I T | | 
I I I 



NOT 
USED 



I 



TYPE 

1 = Volume Set Definition 
= Volume Set Class 

GVCINFO 



k 5 6 



8 9 10 11 12 13 lU 15 



VOLCNT 



NOT 
USED 



VCMASK 



VOLCNT - Number of members in set 

VCMASK - Bit mask of volume member usage (VOLUME CLASS MASK) 
Order is from right to left 
i.e. bit 15 is 1st member, bit lU is 2nd member 

VOLUME MASK FORMAT 



- USED IN MVTAB, PVUSER, FILE CONTROL BLOCK (FCB) , 
VOLUME SET/CLASS DEFINITION, VOLUME SET VTAB. 

- 8-BIT MASK. 



| V7 | V6 | V5 | Vl| | V3 | V2 | VI | V0 | 



I I 



— VOLUME (MASTER) 

--- VOLUME 1 

--- VOLUME 2 

--- VOLUME 3 

--- VOLUME U 

--- VOLUME 5 

--- VOLUME 6 



NOT MOUNTED OR NON-MEMBER 



VOLUME 7 

MOUNTED OR MEMBER 
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CHAPTER 5 LOCK RESOURCES 



SIR# ALLOCATION DST %53 



decimal 


octal 




SIR # 


SIR # 


SIR NAME 


1 


1 


LOAD PROCESS SIR 


2 


2 


LOCK SEGMENT SIR 


3 


3 


IDD 


U 


k 


ODD 


5 


5 


PROCESS TREE STRUCTURE 


6 


6 


SCHEDULING QUEUE 


7 


7 


CST ENTRIES 


8 


10 


SYSTEM DIRECTORY 


9 


11 


LPDT 


10 


12 


LDT 


11 


13 


STORAGE IN OVERLAY AREA 


12 


lU 


DISC FREE SPACE TABLE 


13 


15 


JPCNT 


1U 


16 


JCUT 


15 


17 


JMAT 


16 


20 


FMAVT 


17 


21 


LOADER SEGMENT TABLE 


18 


22 


VDD 


19 


23 


SPOOL 


20 


2k 


MESSAGE CATALOGUE 


21 


25 


RIT 


22 


26 


VOLUME TABLE 


23 


27 


WELCOME MESSAGE SIR 


2k 


30 


ASSOCIATION TABLE 


25 


31 


CS ALLOCATE SIR 


26 


32 


LOGGING BUFFER 


27 


33 


PV MVTAB 


28 


3* 


MEASSIR 


29 


35 


PV USER TABLE 


30 


36 


IMAGE 


31 


37 


KSAM 


32 


U0 


USER LOGGING 


33 


Ul 


DEBUG BREAKPOINT TABLE 


3U 


U2 


PCBSIR 


35 


U3 


SUB-QUEUE MAPPING TABLE 


36 


uu 


CILOG 


37 


U5 


FILE INTEGRITY 


38 


1+6 


RIN 


39 


U7 


TAPE LABELS 


Uo 


50 


1st JOB 


Ul 


51 


2nd JOB 
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MULTIPLE SIR ALLOCATION 



The five conventional chains used by MPE for SIR allocation and 
deallocation are: 

LOWER- >LOGICAL RAMK->HIGHER 

1. LDT(10)->LPDT(9)->VDD(l8) 

2. JMATSIR(15)->LPDT(9)->JPCNT(13) 

3. FMAVTSIR(l6)->FILESIR(37)->DIRECT.(8)->DISC FREE SPACE TBLE(12) 
U. FMAVTSIR(l6)->FILESIR(37)->RIMTABLE(38) 

5. SEGTABSIR (%21)-> BKPTSIR(%Ul)-> LOCKSIR(2) 

Multiple SIR allocation requires care to avoid process deadlock 
situations. The rule that should be followed when working with 
the above SIRs is as follows: 

Never attempt a GETSIR of lower rank than the SIR currently held 
(if any). 

For example: suppose two processes, A and B, required the SIRs for 
the LDT and LPDT. Deadlock would result if done as 
below due to process A not following the convention 
order. 



incorrect order 



correct order 



PROCESS "A" 



PROCESS "B" 



GETSIR(9) [LPDT]- 



GETSIR(IO)- 



DEADLOCK 



•>GETSIR(10) [LDT] 



-GETSIR(9) 
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SIR TABLE INFORMATION 



The system internal resource table is located in non-linked memory 
(resident table). The SIR table is used to protect critical system 
elements against access by more than one process, i.e., it provides 
a "lock out" mechanism. Each critical system resource (usually a 
table) is assigned a specific SIR number. Procedures are provided 
within MPE to lock (GETSIR) and unlock (RELSIR) the SIR. Processes 
attempting to obtain a SIR that is not available are impeded by the 
system. The SIR table entries form the head of a linked list in 
this case. If more than one process becomes impeded, word 8 of the 
PCB entry is used to add the "new" process to the growing list. 
The method of dis impeding the process depends on the SIR type. 



A SIR does not respect process priority and operates in a FIFO 
manner. As processes become impeded on behalf of a SIR the new 
entries are entered at the tail of the impeded list. When the 
current holder of the SIR releases it, only the first process 
in the list (pointed at by the head pointer) is dis-impeded. 
The linked list head and all pointers are then updated and the 
newly dis-impeded process will obtain the SIR. 
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SIR ENTRY FORMATS 



l 2 3 ** 5 6 7 8 9 10 11 12 13 l 1 * 15 



"1--I--I--I--I"!-- 


o 1 


o 1 




PIN of holder 


1 o | 


1 




PIN of holder 


| SIR QUEUE LENGTH j 


TAIL OF IMPEDED LIST(P)|HEAD OF IMPEDED LIST(P) | 



free 

(not locked) 

SIR locked 

(no impeded processes 

SIR locked 

1 (impeded processes) 



P = PIN# 

PIN = PCB table entry number 

SIR QUEUE LENGTH- number of processes queued for this SIR 

The SIR table is indexed by SIR#, each SIR# corresponding to a unique, 
preas signed system internal resource. Entry #0 is not used. 
Impeded lists are established by using the SIR table entry (1). 
(8:8) as the head of the list and PCB(8). (8:8) for elements. 
Pin numbers are always used as pointers, with indicating end 
of list. 
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RIN TABLE GENERAL LAYOUT (Initialized State) 



DST=%26 



RT=RIN TYPE 
(WHEN 
ALLOWED) 



1-LOCAL RIN 
2-GLOBAL 

RIN 
3 -FILE RIN 



SECONDARY 
TABLE OF 12- 
WORD ENTRIES 
FOR GLOBAL 
RIN'S ONLY 



I 

I 

LENGTH= 

# ALLOCATED 

GLOBAL RINS 

*12 



INDEX OF FIRST FREE ENTRY 
(# LOCAL+GLOBAL RINS)*2 



RT 



INDEX OF NEXT FREE 




RT | 



INDEX OF NEXT FREE 




RT 



INDEX OF NEXT FREE 




RT | 



INDEX OF NEXT FREE 




RT 



INDEX OF NEXT FREE 




RT | 



O(EOL) 




FREE LIST POINTER 
TOTAL #OF ENTRIES 



NUMBER FREE ENTRIES 
RESERVED 



IF FREE, PTT TO NEXT FREE| 



I 



i 

| FIRST 
|<- FREE 
- ENTRY 



| LAST 
|<- FREE 
ENTRY 



|0< 
II 



|10 

111 
I 
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ALLOCATION AND LOCKING OF LOCAL RINS 



JOB INFOR 
MATION 
TABLE 



(JIT) 




k3 



RIN TABLE 

INDEX OF FIRST FREE ENTRY 

(NUMBER OF LOCAL+GLOBAL RINS)*2 



1| 



INDEX OF NEXT RIN 



1 



INDEX OF NEXT RIN 



11 



END OF LIST 



DST22(10)=26(8) 



HEAD OF WAITING LIST | PIN OF HOLDER (P) 



P = PIN# 



PCB# waiting processes 
linked through 
PCB impeded queue 
(PCB# pointers) 



PCB# PCB# of process 
that "holds" rin 



LOCAL 
- RIN #1 
I (UNLOCKED) 



I 

I 

- LOCAL 

-RIN #2 

I (UNLOCKED) 



I 
I 

- LOCAL 
RIN #3 

I (LAST) 
(LOCKED) 
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ALLOCATION AND LOCKING OF FILE RINS 



DST22(10)=26(8) 



RIN TABLE 

INDEX OF FIRST FREE ENTRY 

(NUMBER OF LOCAL+GLOBAL RINS)*2 



1 1 I ///////////////////////////////////////// 
HEAD OF WAITING LIST(P)| PIN OF HOLDER 



I 



I 



v v 

PCB# waiting processes PCB# process that 

linked through PCB "holds" rin 

impeded queue 

P=pin# 
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ALLOCATION AND LOCKING OF GLOBAL RINS 



PCB# <■ 

waiting 
processes 



RIN TABLE 

INDEX OF FIRST FREE ENTRY 

(NUMBER OF LOCAL+GLOBAL RINS)*2 



DST22(10)=26(8) 



10 | INDEX OF PASSWORD, USERNAME 



HEAD OF WAITING LIST(P) 



PIN OF HOLDER 



RIN PASSWORD 



USERNAME 
(USER NAME AND ACCOUNT) 



>PCB# 

process 

that 
"holds' 

RIN 



P=pin# 
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1 . Introduction 

2.0 File System Overview 

2.1 Buffers 
3-0 Table Formats 

3.1 File System Section of PCBX (PXFILE) 

3-1.1 Overhead 

3-1.2 Control Block Table (PXFCBT) 

3-1.3 Available Block 

3.1. U Available File Table (AFT) 

3.2 File Control Block Table (CBTAB) 

3.2.1 Overhead 

3.2.2 Vector Table (VT) 

3.2.3 Control Block Area 

3.2.1* Access Control Block (ACB) 

3.2.5 Logical Access Control Block (LACB) 

3.2.6 Physical Access Control Block (PACB) 
3-2.7 File Control Block (FCB) 

3-3 File Label (FLAB) 

3.U File Multi-Access Vector Table (FMAVT) 

3.5 System Global Area (SYSGLOB) 

3.6 SIRs, Locks, and Deadlocks 



6-1 



1.0 Introduction 



This document describes the MPE-IV file system. Section 2 describes the 
basic concepts. Section 3 describes the table structures used. 



2.0 File System Overview 



I/O to files is done by reference to file numbers, which are assigned by 
calling the FOPEN intrinsic. This establishes an initial "point of 
attachment", which may be described as a connection between a program 
(i. e., process) and that particular point in a particular file at which 
the next FREAD or FWRITE would cause data to be transferred. A point of 
attachment is described by a control block, of which there are several 
different kinds (described later). Control blocks may exist in the 
process's own stack, in an extra data segment assigned by the file 
system, or (because of file sharing) in some other process' stack. In 
order to find control blocks quickly, a pointer scheme called vectors is 
used. A control block is uniquely described by a vector, which consists 
of one word with the low ten bits containing a segment number, and the 
upper six containing an index into a table (the "vector table") which 
describes the location of the control block within that segment. The 
entire assemblage, consisting of five overhead words, the vector table, 
and all of the control blocks to which it points, comprises a contiguous 
piece of storage called the "control block table". If it is in an extra 
data segment, the control block table comprises the entire segment; if 
in a stack, it occupies part of the PXFILE part of the PCBX, usually 
beginning at segment-relative location 106 octal. 

The point of attachment is described by a "physical access control 
block", or PACB, which will exist as a result of an FOPEN to any file 

(except $NULL). Any required I/O buffers are associated with the PACB; 

see section 2.1. 

All FOPENs specifying "multi-access" for all processes running under a 
single job use a single PACB for references to a multi-access file. 
Although all these are attached to a single point in the file, the type 
of attachment (i. e. , AOPTIONS) may be different. So, each FOPEN 
specifying a multi-access file establishes a "logical access control 
block", or LACB, which contains the point -of -attachment local values. 
The use of a single buffer (i. e., PACB) insures that references by 
various processes or against various FOPENs within one process are dealt 
with in strict sequential order. Note that references to a file by 
other jobs, or by other processes not specifying multi-access, will be 
through other PACBs, whose buffers will be read or written at the 
pleasure of the file system; in order to insure any sort of coherence to 
such shared references, the jobs must use global RINS and FLOCK and 
FUNLOCK the file. $STDIN, $STDLIST, and spoolfiles are opened 
multi-access automatically. 
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In the case of disk files, there is another kind of control "block: the 
file control block, or FCB. It contains copies of information read from 
the file label, such as the end- of-file pointer, the extent map, and 
the record and block structure. The EOF pointer is updated in the FCB 
as the file is written, and all changes made to the FCB are posted to 
the file label when the file is closed. An FCB is shared by all jobs in 
the system which reference the file. 

The file number assigned by an FOPEN is an index into the Available File 
Table (AFT) , a table of four-word entries which is at the end of the 
PXFILE part of the PCBX. Two of these words are vectors to the PACB and 
(if it exists) the LACB. 

Because control blocks are shared among processes, it is necessary to 
have a scheme for coordinating access to them. A control block is 
"locked" by a process which requires exclusive access to it for a time. 
Other processes which attempt to lock the block will find it already 
locked, and will be impeded and queued. It may also be necessary to 
lock an entire control block table so that a process can create or 
destroy a control block in it, or lock or unlock an existing control 
block in the table. 

Another table used by FOPEN is the File Multi-Access Vector Table 
(FMAVT) . This table exists in a system extra data segment and is used by 
all jobs and processes in the system. When a file is being FOPENed with 
multi-access specified, the FMAVT is searched; if the file is already 
open, the FMAVT gives the PACB vector for the prior reference for each 
job. 



2 . 1 Buffers 



A bit in AOPTIONS specifies, when a file is opened, whether access is to 
be buffered or unbuffered. If unbuffered, data is transferred directly 
between the I/O device and the user's buffer (usually in his stack), 
which will be frozen in memory for the duration of the transfer. If 
buffered, the data is moved between the user's buffer and a file system 
buffer to which the I/O is actually done. 

Buffers are associated with the PACB, attached to it as an appendage. 
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3.0 Table Formats 



This section gives a detailed discussion of the main tables constructed 
and used by the file system. The location and overall structure of each 
table is given, in addition to the table format and a discussion of each 
field in the table. Table indices at the right of the table are in 
octal. Index names apply to the entire word; if in parentheses, the 
names are defined in the file system listing but not explicitly used 
there . 



3-1 File System Section of PCBX (PXFILE) 



The PXFILE area is a sub-section of the PCBX. It is a contiguous, 
expandable and contractable block of storage that is managed by the file 
system primarily for its own use. Other subsystems, namely CS and DS, 
also make use of the PXFILE section. In doing so they must conform to 
the conventions of the file system. 

The overall structure of the PXFILE area is: 



Overhead 



Control block 
table 



Available 



Active File 
Table 



66 



106 



(fixed) 



(variable) 



(variable) 



(variable) 



DL-5 



6-k 



3.1.1 Overhead 



The part labeled Overhead contains information that pertains to the 
entire section. It ordinarily begins at segment -relative location 66 
octal, but is usually addressed via the pointer at DL-3. 



PXFSIZE 

1 

2 

3 (PXFDSINFO) 

k 

5 PXAFTSIZE 

6 (PXCTRINFO) 

7 PXFLEFTOFF 

10 PXFCBT1 

11 (PXFCBT2) 

12 (PXFCBT3) 

13 (PXFCBTU) 
lU (PXFCBT5) 

15 (PXFCBT6) 

16 (PXFCBT7) 

17 (PXFCBT8) 



1 




7 8 


15 


| PXFILE size in words | 


j Last DOPEN error no. | Last COPEN error no. j 


|N| | 


| Reserved for DS | 


j Last KOPEN error 


number | Last 


FOPEN error number | 


| AFT size in words | 


j CS Trace file info j 


| Last re: 


sponding NO-WAIT I/O AFT entry number | 


| 1st user 


(NOCB) 


control block 


table DST number | 


j 2nd user 


(NOCB) 


control block 


table DST number | 


| 3rd user 


(NOCB) 


control block 


table DST number | 


I Uth user 


(NOCB) 


control block 


table DST number | 


| 5th user 


(NOCB) 


control block 


table DST number | 


| 6th user 


(NOCB) 


control block 


table DST number | 


I 7th user 


(NOCB) 


control block 


table DST number | 


| 8th user 


(NOCB) 


control block 


table DST number | 
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Partial word field identifiers are: 



N 



PXFDOPEN 

PXFCOPEN 

PXFNOCB 

PXFKOPEN 

PXFFOPEN 



Discussion: 
PXFAFTSIZE 

PXFCBT1-8 

PXFCOPEN 

PXFCTRINFO 

PXFDOPEN 

PXFDSINFO 
PXFFOPEN 



PXFKOPEN 



PXFLEFTOFF 



= PXFILE(1).(0:8)#, 
= PXFIIK(1).(8:8)#, 
= PXFIL*:(2).(0:1)#, 
= PXFILE(U).(0:8)#, 
= PXFILE(l4).(8:8)#, 



last DOPEN error code 
last COPEN error code 
no CB's in PXFILE CBT? 
last KOPEN error code 
last FOPEN error code 



This is the size (in words) of the Active File Table 
(AFT). The size is in words to simplify calculating the 
size of the available block. 

These are the DST numbers of the user (NOCB) control 
block tables. A DST number of indicates that no data 
segment is allocated. 



This contains the last COPEN error number, 
the file system. 



Not used by 



This contains information pertinent to the CS trace 
file. Not used by the file system. 

This contains the last DOPEN error number. Not used by 
the file system. 

Reserved for DS. Not used by the file system. 

This contains the last FOPEN error number. If it is 
zero then the last FOPEN completed successfully; 
otherwise the last FOPEN was unsuccessful and the 
number is the file system error number. 

This contains the last KOPEN error number. KSAM is 
partly imbedded in the file system, and an FOPEN 
failure on a KSAM file can be caused by a failure to 
open either the key file or the data file. This error 
number is used in conjunction with PXFFOPEN to 
determine which file caused the KSAM open failure. 
This error number is not used by the file system. 

This is the AFT entry number of the last file/line that 
completed a no-wait I/O; if zero then no no-wait I/O 
has been completed. This cell is maintained solely by 
and for the IOWAIT intrinsic. 
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PXFNOCB This bit signifies that control blocks are not to be 
created in the PXFILE control block table. This bit is 
set by the NOCB parameter to the CREATE intrinsic or 
the :RUN command. This feature permits the user to 
have as much stack space as possible; " otherwise the 
file system will take several hundred words of stack 
for the PXFILE control block table. 

PXFSIZE This is the size (in words) of the complete PXFILE 

area. It is the sum of the overhead block, the control 

block table, the active file table and the available 
block . 
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3.1.2 PXFILE Control Block Table (PXFCBT) 



Addressing within a PXFILE control block table is somewhat more 
complicated than addressing an extra data segment CBT since the table 
does not begin at DB+O, As a result all pointers within the table are 
table relative; the starting address of the table must be added to a 
pointer to generate a final DB-relative address. This addressing 
convention is consistently applied to all control block tables. 

When the control block table is expanded, space is taken from the 
AVAILABLE area. If no space is available then the PXFILE area is 
expanded and the acquired space is added to the AVAILABLE area. 



Refer to section 3-2 for a more detailed 
block tables. 



description of file control 



12 



15 



Table size in words 



KIT number containing table 

Vector table size in words 



Lock word 
Impeded queue 



Vector table 



Control block area 



20 (PXFCBTAB) 

21 PXFDSTX 

22 PXFVTSIZE 

23 (PXFLOCK) 
2k (PXFQUEUE) 
25 PXFVT 



The following identifier is also used: 

PXFCBTSIZE = PXFILE(l6)#, table size in words 
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Discussion: 
PXFCBTAB 

PXFCBTSIZE 
PXFDSTX 



PXFLOCK 



PXFQUEUE 

PXFVT 
PXFVTSIZE 



This is the first word of the control block 
is used when referring to the entire table. 



table ; it 



This is the size in words of the control block table. 
It is used principally for calculating the size of the 
available block. 

This is the DST number of the data segment that 
contains the control block table. This is the same as 
the DST number of the stack itself. The common 
convention of referring to the DST number of the stack 
as zero is not used, because the file system may refer 
to a PXFILE control block table in another stack, which 
would result in an ambiguity since that PXFILE control 
block table would also have a DST number of zero. 

This is the lock word for the table and has the same 
format as the lock word for a control block in the 
table, i. e. lock bit, break bit, lock count, and 
locking PIN. 

This is the impeded queue for the table and has the 
same format as the impeded queue for a control block in 
the table. 

This is the first word of the vector table. It is used 
when referring to the vector table in general. 

This is the size, in words, of the vector table. This 
is the length of the table and does not reflect the 
number of entries used or unused. 



3.1.3 Available Block 



The part labeled Available is used to provide space when the Control 
Block Table or the Active File Table is expanded. These two tables grow 
towards each other, and when more space is needed it is simply taken 
from the Available Block. 

When the Available area is exhausted, the PXFILE area is expanded, the 
AFT is relocated and the new space is added to the Available Block. 

Currently the PXFILE area is only expanded; it is never contracted. 
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3.1.U Available File Table (AFT) (also called Active File Table.) 



The part labeled Available File Table contains information used by the file 
system (or CS, DS, etc.) to grossly characterize the file access and, 
most importantly, to give the location of the control blocks. 

The overall structure of the AFT is: 



Entry M 



(fixed, k words) 



Entry 1 



DL-8 

(fixed) 
DL-5 



where N = FXFAFTSIZE/U. 

The length of the AFT is specified by PXFAFTSIZE. Unused entries are 
all zeroes. When the table is full it is expanded by taking space from 
the Available block. *^ 

The AFT is negatively indexed by file number: the entry at DL-8 
corresponds to file number 1, the entry at DL-12 corresponds to file 
number 2, etc. 

The structure of a file system AFT entry is: 



1 2 3 U 5 


15 


I Entry type | N | | 


1 Physical ACB Vector j 


1 Logical ACB Vector | 


1 NO- WAIT I/O IOQX | 



1 AFTPACBV 

2 AFTLACBV 

3 AFTIOQX 
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The entry format depends on the entry type; the file system uses entry 
type 0. 

The following partial word field identifiers are used: 



AFTTYPE = AFT.(0:1*)#, entry type 
AFTNULL = AFT. (!*:!)#, $NULL file 



Discussion: 

AFTIOQX This is the IOQ index of the pending no-wait I/O (if 
any) . This is applicable if the file was opened with 
the NOWAIT option specified. Also, CS and DS have the 
same capability and use this cell in a consistent 
manner. This is because the IOWAIT intrinsic services 
the file system as well as CS and DS, and is the prin- 
cipal user of this cell. In the case of a message file 
the accessor" s reply port (file system basic IPC port) 
is stored in this cell. If this cell is zero there is 
no no -wait I/O pending. 

AFTLACBV This is the vector of the Logical ACB (LACB) (if any). 
This is applicable if the file was opened with the 
multi-access option specified. 

AFTNULL This bit signifies that the file is $NULL and that 
there are no control blocks. 

AFTPACBV This is the vector of the Physical ACB (PACB). A PACB 
exists for all files except $NULL. 

AFTTYPE This is the AFT entry type number. At present the 
following entry types are defined: 

- file system 

1 - remote file 

2 - DS (no-wait I/O disallowed) 

3 - DS (no-wait I/O allowed) 
U - CS 

5 - CS 

6 - KSAH 

7 - 3270 

8 - Message File 
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3.2 File Control Block Table (CBTAB) 



A file control block table can be located in two places: (a) as a 
sub-part of the PXFILE area, as discussed in section 3.1.2; or (b) in a 
data segment. Although putting control block tables in PXFILE has the 
advantage of providing rapid access, it detracts from the space for the 
user's stack; so the larger control blocks (or optionally, all control 
blocks) are put into extra data segments. On the other hand, 
referencing extra data segments may result in an absence trap, which is 
slow. Extra data segment control block tables are of three kinds: 
expandable, non-expandable, and shared FCB. Non-expandable CBT's are 
used for a single PACB with buffers, i. e. where the control block is 
large, or where the control block can't be local to a single process, i. 
e., for multi-access. Expandable (or NOBUF) CBT's are used for small 
control blocks, to wit, LACB's, PACB's with no buffers, and FCB's which 
are local to a single process. A list of the expandable CBT's 
associated with a process is kept in the overhead area of PXFILE (cf. 
section 3.1.1). When a small control block is needed, these CBT's are 
checked in order to see if one of them has room. Shared FCB CBT's are 
like expandable CBT's except that they belong to the system rather than 
to a single process; the system keeps a list of DST's which it has 
assigned for this purpose. 

The overall structure of a control block table is: 



Overhead 



(fixed, 5 words) 



Vector Table 



(variable) 



Control Block 
area 



(variable) 
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3.2.1 Overhead 



The part labeled Overhead contains information pertaining to the entire 
table . 



1 


2 




6 7 15 


J Table size in words ! 






DST 


Number containing table | 


1 Type 






| Vector table size in words | 


j Lock word 1 


j Impeded queue 1 



CBTSIZE 

1 CBTDSTX 

3 CBTLOCK 

U (CBTQUEUE) 



Other identifiers used: 



CBTTTPE = CBTAB(2).(0:2)#; control block table type 
CBTVTSIZE = CBTAB(2).(7:9)#; vector table size 



Discussion: 
CBTDSTX 



CBTLOCK 



This is the DST number of 

contains the control block 

contained in a stack, i.e. in the PXFILE area, 

this is the DST number of the stack and not 0. 



the data segment that 
table. If the table is 

then 



CBTQUEUE 



This is the lock word for the table and has the same 
format as the lock word for a control block in the 
table, i. e. lock bit, break bit, lock count, and 
locking PIN. The table is locked, thus insuring 
exclusive access, whenever a control block is being 
created or destroyed. It isn't necessary to lock the 
table while locking a control block within it because 
control block locking is done pseudo-disabled. 

This is the impeded queue for the table and has the 
same format as the impeded queue for a control block in 
the table. There is no second impeded queue because 
that facility is used exclusively for BREAK requests 
against the PACB for $STDIN/$STDLIST. 
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CBTSIZE This is the size in words of the table. It is 
initialized when the table is created and changed when 
the table is expanded. At present a table is never 
contracted, even though this is possible. 

CBTTYPE This field is the type of the control block table. 
Possible values are: 

- stack [PXFILE] 

1 - NOBUF (expandable) 

2 - System shared FCB 

3 - Buffered (contains a single PACB) 

CBTVTSIZE This is the size, in words, of the vector table area in 
the control block table. It does not reflect the 
number of entries used or unused. 
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3.2.2 Vector Table 



The part labeled Vector Table contains information used to locate and 
lock or unlock control blocks in the control block table. 

The vector format is found in section 7- 3^ of Chapter 7- 
The overall structure of the vector table is: 



Entry 



(fixed, k words) 



Entry N 



(fixed) 



where N * (CBTVTSIZE/U)-1. Since only six bits are available for a 
vector table index, the vector table can contain at most 6U entries. 

An unused vector table entry will have zeroes in all the words of the 
entry. A used vector table entry will have a non-zero value in the 
first word of the entry (the control block address is necessarily 
non-zero) . 



The general structure of a vector table entry is: 



Control block address 
Control word 



High priority impeded queue 
Low priority impeded queue 



15 



VTADR 

1 VTCONTROL 

2 (VTQUEUE) 

3 (VTSAVEDQUEUE 
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Discussion: 
VTADR 



VTCONTROL 



VTQUEUE 



VTSAVEDQUEUE 



Control block address is the table relative address of 
the control block associated with the vector table 
entry. It is a word displacement from the beginning of 
the control block table. 

The control word is used to coordinate access to the 
control block. It contains a bit which indicates that 
the control block is being accessed, and therefore 
"locked", and a byte which contains the PIN of the 
process which has exclusive access to the control 
block. Other processes attempting to access the block 
will be impeded and queued. 

The high priority impeded queue is a byte pair of PINs 
that are the head and tail of the impeded queue of 
processes waiting for access to the control block. 
Processes are impeded and unimpeded by the file system 
using the normal mechanisms available under HPE. 

The low priority impeded queue is a byte pair of PINs 
and has the same format as VTQUEUE. The only time this 
word is used is when the control block is in BREAK 
mode, which can only happen to an ACB corresponding to 
$STDIN/$STDLIST. It is used to save the current 
VTQUEUE when the control block goes into BREAK mode and 
to restore VTQUEUE when the control block goes back 
into non-BREAK mode. 



The last three words of a vector table entry comprise a sub-block for 
the locking system that is used to coordinate access to a particular 
control block. 

The structure of the vector table entry control sub-block is: 



12 7 8 

I L | B | Lock count | 
I 



15 



Lock PIN 



High priority tail PIN | High priority head PIN 
Low priority tail PIN | Low priority head PIN 



CBLC0NTR0L 

1 CBLQUEUE 

2 CBLSAVEDQUEUE 
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The following partial word field identifiers are used: 



CBLLOCK 

CBLBREAK 

CBLCOUNT 

CBLPIM 

CBLTAIL 

CBLHEAD 

CBLSAVEDTAIL 

CBLSAVEDHEAD 



CBL.(0:1)#, 

CBL.(1:1)#, 

CBL.(2:6)#, 

CBL.(8:8)#, 

CBL(1).(0:8)#, 

CBL(1).(8:8)#, 

CBL(2).(0:8)#, 

CBL(2).(8:8)#; 



lock bit 

break bit 

lock count 

PIN holding lock 

high priority tail PIN 

high priority head PIN 

low priority tail PIN 

low priority head PIN 



Discussion: 
CBLBREAK 

CBLCONTROL 

CBLCOUNT 



CBLHEAD 
CBLLOCK 
CBLPIN 

CBLQUEUE 
CBLSAVEDHEAD 

CBLSAVEDQUEUE 

CBLSAVEDTAIL 

CBLTAIL 



This is the BREAK bit and is used only for the ACB 
corresponding to $STDIN/$SDTLIST. 

This identifier is used when referring to the first 
word of the vector table control sub-block. 

This is a count of the number of times that the control 

block is locked by CBLPIN. It is if the control 

block is not locked and is greater than if the 
control block is locked. 

This is the PIN of the process at the head of the high 
priority impeded queue. 

This is the lock bit for a control block; 1 denotes 
locked. 

This is the PIN of the process which has locked the 
control block and has exclusive access to it. If the 
control block is not locked then this field is 0. 

This is the high priority impeded queue. 

This is the PIN of the process at the head of the low 
priority impeded queue. 

This is where CBLQUEUE is saved when creating a break 
queue . 

This is the PIN of the process at the tail of the low 
priority impeded queue. 

This is the PIN of the process at the tail of the high 
priority impeded queue. 
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3.2.3 Control Block Area 



The part labeled CONTROL BLOCK AREA contains the control blocks used by 
the file system. 

To facilitate storage management, all control blocks have the same 
overall structure: 




CBDESCRIP 

1 



N 



where H = Size-1. 

Partial word field identifiers are: 



CBTTPE 
CBSIZE 



CB.(0:2)#, 
CB.(2:lU)#; 



control block type no. 
control block size 



Discussion: 
CBDESCRIP 

CBSIZE 

CBTYPE 



This is the first word of a control block; the format 
is common for all control blocks. 



This is the size (in words) of the control block, 
size includes the descriptor word. 

This is the type number of the control block. 
are four types of control blocks: 



The 



There 




1 
2 
3 



Garbage 
FCB 
PACB 
LACB 



When a control block table is created the initial control block area is 
completely allocated to a single control block of type garbage. When 
space is requested for a new control block the control block area is 
scanned (using a first fit algorithm) for a garbage control block that 
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is as large as the size requested. The space for the new control block 
is taken from this garbage control block and the space remaining becomes 
the new garbage control block size. 

When space is returned it becomes a new garbage control block. To 
reduce fragmentation the new garbage control block is combined with 
either of the two neighboring control blocks if they are of type 
garbage . 

If space is requested and no garbage control block is large enough to 
contain the new control block then the control block area and control 
block table are expanded by a sufficient amount. If expansion is not 
possible, some other control block table must be used. 



3.2.U Access Control Block (ACB) 



Virtually every file system intrinsic constructs an ACB as its first 
action. When using the multi-access option, each accessor shares a 
single PACB. However each accessor is permitted to view the shared file 
in a slightly different manner than the other accessors. For example, 
one accessor may access the file in a read-only mode while the other 
accessors may access the file in a read-write mode. To do this, each 
accessor must, during his access, have a slightly different ACB. 

The PACB holds information that is global to all accessors of the file. 
The LACB holds information that is local to each accessor of the file. 
At the beginning of a particular access, an ACB is constructed by 
calling LOG' ACB, which copies information from both the LACB and the 
PACB. At the end of the access, the ACB is released by calling 
UNLOC'ACB; this updates the PACB and LACB from the ACB since some of the 
fields may have been modified due to the access. This scheme nearly 
eliminates EXCHANGEDB's to access the various data segments. 
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3-2.5 Logical Access Control Block (LACB) 

All LACBs have the same structure: 

1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 



1 3 1 




Complete LACB size 






1 I File number | 


I File 


name 


- 1st char. | File name - 


2nd 


char. | 


I File 


name 


- 3rd char. | File name - 


Uth 


char. | 


I File 


name 


- 5th char. | File name - 


6th 


char. | 


! File 


name 


- 7th char. | File name - 


8th 


char. | 


1 FOPTIONS S 


1 AOPTIONS | 


1 Record size in bytes j 


i Block size in words j 


1 Reserved for PACBV j 


1 Carriage control code j 


I |E0F|Pg |Ln |St |FK |TC |TB |8B |Car|DB | EOF T | 


EOF M | | 






| TE| IC| Q | | Terminal stop 


character j 






Error code 










Last I/O transmission log 







10 

11 

12 
13 

Ik 

15 
16 

17 



Partial word field identifiers are: 



LACBSIZE = LACB.(2:lU)#, size in words 
LACBSTOPCHAR = LACB (2) . (0:8)#, terminal stop character 
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Discussion: 

LACMOPTIONS 

LACBBSIZE 

LACBCTL 

LACBERROR 

LACBFNUM 

LACBFOPTIONS 

LACBHODE 

LACBNAHE1-8 

LACBPACB 

LACBRSIZE 
LACBSIZE 

LACBSTATE 

LACBSTOPCHAR 

LACBTLOG 



See ACBAOPTIONS. 

See ACBBSIZE. 

See ACBCTL. 

See ACBERROR. 

See ACBFNUM. 

See ACBFOPTIONS. 

See ACBMODE. 

See ACBNAME. 

This is the vector of the Physical ACB (PACB) for the 
file. 

See ACBRSIZE. 

This is the size, in words, of the LACB. All LACBs are 
sixteen (decimal) words long. 

See ACBLSTATE. 

See ACBSTOPCHAR. 

See ACBTLOG. 
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3.2.6 Physical Access Control Block (PACB) 



The overall structure of the PACB is; 



Basic PACB 



(fixed) 



Buffering 
extension 



(variable) 



The buffering extension is optional; it is present if and only if the 
file is accessed with buffering. There are thus two possible formats 
for an ACB: 

1. Mo buffers; the buffering extension is not present. 

2. PACB buffers; the buffering extension is present and the 
buffers are in the buffering extension. 

If multiple PACB buffers exist, there will be a buffering extension for 
each, immediately preceding the buffer. The basic PACB (or KOBUF PACB) 
is copied into the the ACB as words thru 57 octal; an ACB "extension" 
is then generated in words 60 thru 67 '• The resulting ACB thus has the 
following format: 



6-22 



12 3 


k 5 6 7 8 9 10 11 12 13 lU 15 


1 2 | 




Complete ACB size 






| | File number | 


| File 


name 


- 1st char. | File name - 


2nd 


char. | 


| File 


name 


- 3rd char. | File name - 


Jtth 


char. | 


| File 


name 


- 5*h char. | File name - 


6th 


char. | 


| File 


name 


- 7th char. | File name - 


8th char. | 


| FOPTIONS | 


! AOPTIOHS 1 


| - Record size in bytes 1 


| Block size in words 1 




(Res 


erved for PACBV, if multi-access) 








Carriage control code 






| |EOF|Pg |Ln 


|St |FK |TC |TB |8B |Car|DB | EOF 


T | 


EOF M | 1 






| TE| IC| Q | | Terminal stop 


character | 


j Error code I 






Last I/O transmission log 






j File pointer 1 


j Current variable block number 1 


j Record transfer count ! 


j Block transfer count 1 



1 

2 

3 
U 

5 
6 

7 
10 
11 
12 

13 
1U 

15 
16 
17 
20 
21 
22 

23 
2k 

25 

26 
27 



6-23 



Highest block number started 



I 30 

I 31 

FCB Vector | 32 

Spare j 33 

No. input LACB'S | Total no. LACB'S | 3*» 

|Bk I Device type | Last logical I/O status | 35 

AE |RW |ABR|NE | SEOFS | EOFS | Blocking factor | 36 

PF I Hit I I Current buffer | | No. buffers | 37 

Current record word index j U0 

Buffer size j Ul 

Spare j 1*2 

FMAVT index | 1»3 

Volume table index j kU 

Name type | File disposition | 1*5 

Access bit map | Logical device number | 1*6 

S I M f Q I R I r> I I Virtual logical device no. | 1*7 

Spooled device type | Spooled device record size | 50 

Spooled device FOPTIONS | 51 

Spooled device AOPTIONS | 52 

IDD or ODD Index | 53 



No -Wait disk address 



5U 

55 
Spare j 56 

Spare j 57 



6-2k 



PACB DST nr. 



60 
61 
62 

63 

6k 

65 
66 

67 



PACB offset (DST-rel.) 
LACB DST nr. 



LACB offset (DST-rel. ) 



ACB offset (Stack-DST-rel.) 
DB offset (Stack-DST-rel.) 



Stack-DST-rel location of PXFILE CBTAB 
CBTAB-rel vector table entry address 



The following identifiers are used when referring to an ACB: 



(ACBSIZE) 


= 


ACB. (2:lU)#, 


size in words 


ACBFNUM 


= 


ACB(1).(8:8)#, 


file number 


ACBNAME 


= 


ACB(2)#, 


file name 


ACBNAME1 


= 


ACBDBL(1)#, 


file name - first half 


ACBNAME2 


= 


ACBDBL(2)#, 


file name - second half 


ACBFOPTIONS 


= 


ACB(6)#, 


FOPTIONS 


ACBAOPTIONS 


= 


ACB(7)#, 


AOPTIONS 


ACBRSIZE 


= 


ACB(8)#, 


record size (bytes) 


ACBBSIZE 


= 


ACB(9)#, 


block size (words) 


ACBCTL 


= 


ACB(11)#, 


carriage control word 


ACBLSTATE 


= 


ACB(12)#, 


local state flags 


ACBEOF 


= 


ACBLSTATE. (1:1)# 


end of file sensed 


ACBLPCTL 


= 


ACBLSTATE. (2: 2 )# 


page and line control 


ACBPAGECTL 


= 


ACBLSTATE. (2 :1)# 


page control 


ACBLINECTL 


= 


ACBLSTATE. (3: 1)# 


, line control 


ACBSTREAM 


s 


ACBLSTATE. (k: 1)# 


stream I/O 


ACBFKEYS 


= 


ACBLSTATE. (5 :1)# 


restore function keys 


ACBXMITCRLF 


= 


ACBLSTATE. (6 :1)# 


transmit CR,LF to user 


ACBTBLOCK 


= 


ACBLSTATE. ( 7: 1)# 


, disable block mode 


ACBBINARYIO 


= 


ACBLSTATE. (8 :1)# 


8-bit terminal transfers 


ACBCARRIAGE 


= 


ACBLSTATE. (9 :1)# 


, carriage control flag 


(ACBDEFBLOCK) 


= 


ACBLSTATE. ( 10 :l)i 


( , default blocking 


ACBREADCODE 


= 


ACBLSTATE. ( 11 :k)i 


U input EOF check 


ACBREADTYPE 


= 


ACBLSTATE. (11: 2) i 


f y input EOF type 


ACBREADMODE 


= 


ACBLSTATE. (13: 2) i 


f ; input EOF mode 


ACBMODW 


= 


ACB(13)#, 


mode word 


ACBMODE 


= 


ACBMODW. (0:8)#, 


mode setting 


ACBTAPEERROR 


= 


ACBMODW. (U:l)#, 


report recovered tape error 


ACBINHIBCRLF 


- 


ACBMODW. (5:1)#, 


inhibit terminal CR/LF 



6-25 



ACBQUIESCE 


= 


ACBMODW.(6:l)#, 


ACBSTOPCHAR 


= 


ACBMODW. (8:8)#, 


ACBERROR 


= 


ACB(lU)#, 


ACBTLOG 


= 


ACB(15)#, 


ACBFPTR 


= 


ACBDBL(08)#, 


ACBBLK 


= 


ACBDBL(09)#, 


ACBRTFRCT 


= 


ACBDBL(10)#, 


ACBBTFRCT 


= 


ACBDBL(11)#, 


ACBHIBLK 


= 


ACBDBL(12)#, 


ACBFCB 


= 


ACB(26)#, 


ACBSHCNTS 


= 


ACB(28)#, 


ACBSHCNTIN 


= 


ACBSHCNTS. (0:8)#, 


ACBSHCNT 


= 


ACBSHCNTS. (8 :8)#, 


ACBSTATW 


= 


ACB(29)#, 


ACBBREAK 


= 


ACBSTATW. (1:1)#, 


ACBDTYPE 


= 


ACBSTATW. (2: 6 )#, 


ACBACCCL 


= 


ACBSTATW. (2: 3 )#, 


ACBSUBCL 


s 


ACBSTATW. ( 5: 3)#, 


ACBSTATUS 


= 


ACBSTATW. (8:8)#, 


ACBQSTATUS 


= 


ACBSTATW. (8: 5)#, 


ACBGSTATUS 


= 


ACBSTATW. (13 :3)#, 


ACBGSTW 


= 


ACB(30)#, 


ACBNOWAITEOF 


= 


ACBGSTW. (0:1)#, 


ACBNOWAITMODE 




= ACBGSTW. (1:1)#, 


ACBABORTREAD 


= 


ACBGSTW. (2:1)#, 


ACBNEWEOF 


3 


ACBGSTW. (3 :1)#, 


ACBSAVEEOFS 


= 


ACBGSTW. (U:2)#, 


ACBEOFS 


= 


ACBGSTW. (6:2)#, 


ACBBLKFACT 


= 


ACBGSTW. (8:8)#, 


ACBBUFX 


= 


ACB(31)#, 


ACBPRIV 


= 


ACBBUFX. (0:1)#, 


ACBHIT 


= 


ACBBUFX. (1:1)1, 


ACBCURRBUF 


= 


ACBBUFX. (k :!»)#, 


ACBNUMBUFS 


= 


ACBBUFX. (12:U)#, 


ACBBUFUSED 


= 


ACB(32)#, 


ACBBUFSIZE 


= 


ACB(33)#, 


ACBXXXX 


= 


ACB(3U)#, 


ACBFMAVTX 


= 


ACB(35)#, 


ACBVDADDR 


s 


ACB(36)#, 


ACBDHTD 


= 


ACB(37)#, 


ACBDNTYPE 


= 


ACBDNTD.(0:8)#, 


ACBDISP 


= 


ACBDNTD.(8:8)#, 


ACBAMLD 


= 


ACB(38)#, 


ACBACCESS 


= 


ACBAMLD. (0:8)#, 


ACBDADDR 


= 


ACBAMLD. (8 :8)#, 


ACBSPFL 


= 


ACB(39)#, 


ACBSPOOLED 


= 


ACBSPFL. (0:1)#, 


ACBSPOOLIO 


= 


ACBSPFL. (0:2)#, 


ACBSPSQ 


= 


ACBSPFL. (2:2)#, 


ACBSPSQZ 


= 


ACBSPFL. (2:1)#, 


ACBSPRSQ 


= 


ACBSPFL. (3:1)#, 


ACBSPDSQ 


= 


ACBSPFL. (1»:1)#, 



critical output verify 
terminal stop character 
error code 

last I/O transmission log 
current record number 
current variable block 
logical record tfr count 
block transfer count 
highest block started 
FCB vector 

LACB counts 

# of Read LACB'S 

# of LACB'S 

access class, status, etc. 

break ($STDIN/LIST only) 

device type 

device access class 

device sub- class 

last logical I/O status 

qualifying status part 

general status part 

global state flags 

EOF advanced? 

last I/O: = read, 1 = write 

abort broken re-read? 

EOF advanced - tape file 

for saving ACBEOFS 

EOF flags - :EOD/: 

records /block 

buffer data & misc. flags 

privileged access only 

buffer hit flag 

current buffer nr. 

number of buffers less 1 

used block word count 

buffer size (words) 

spare 

FMAVT index 

volume table index 

type & disposition 

name type for dir. search 

file disposition 

access mask & LDEV 

access mask 

logical device number 

spool control flags 
spooled device flag 
spooled IN/OUT 
squeeze flags 
file squeezed 
request to sqz 
squeeze just done 
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ACBSPVDEV 

ACBSPTYRC 

ACBSPTYPE 

ACBSPREC 

ACBSPFOPT 

ACBSPAOPT 

ACBSPXDDX 

ACBNOWAITDA 

ACBNOWAITLDEV 



ACBSPFL.(8:8)#, 

ACB(UO)#, 

ACBSPTYRC. (0:6)#, 

ACBSPTYRC. (6: 10)#, 

ACB(1+1)#, 

ACB(i+2)#, 

ACB(U3)#, 

ACBDBL(22)#, 

ACB(27)#, 



spooled virtual device 
spooled dev type/recsize 
spooled dev type 

spooled dev rec size 
spooled dev FOPTIONS 
spooled dev AOPTIONS 
IDD/ODD index 
No-wait disk address 



Discussion: 
ACBABORTREAD 



ACBACCCL 



ACBACCESS 



This flag is used to abort a broken terminal re-read. 
The flag is set via the ABORT parameter to FUNBREAK. 
If the flag is set then the READ PENDING message will 
be aborted along with the re-read. This feature is 
needed to handle the BREAK. .. : ABORT, etc. situation. 

This is the access class part of the device type 
number. The following are legal values: 

- direct (e.g. disc) 

1 - serial input (e.g. card reader) 

2 - parallel input /output (e.g. terminal) 

3 - serial input /output (e.g. mag tape) 
U - serial output (e.g. line printer) 

This is the access bit map for the file. The following 
are the bit definitions of this eight-bit field: 



(0:1) 


- unused 


(1:1) 


- unused 


(2:1) 


- read 


(3:1) 


- append 


(*t:l) 


- write 


(5:1) 


- lock 


(6:1) 


- execute 


(7:1) 


- save 



This access security is determined by the ACCCHECK 
intrinsic and enforced by the file system. 

ACBAOPTIONS This is the AOPTIONS in effect for this file access. 

ACBBINARYIO This bit controls full eight bit transfers on the 26UU 
page mode terminal. It is adjusted by FC0NTR0L ( 26 ) and 
FC0NTROL(27). 

ACBBLK This is the block number of the current variable record 
format block. Applicable iff the record format is 
variable . 
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ACBBLKFACT 



ACBBREAK 



ACBBSIZE 
ACBBTFRCT 

ACBBUFUSED 
ACBCARRIAGE 



ACBCTL 



ACBCURRBUF 



ACBDADDR 



ACBDEFBLOCK 



ACBDISP 



This is the blocking factor for the file. It is the 
number of records in a block. Legal values range from 
1 to 255. 

This is the break mode flag. It is applicable iff the 
ACB is for $STDIN or $STDLIST. If set it means that 
the BREAK key has been hit and that the CI should have 
high priority access to the ACB. The flag will be 
cleared when a RESUME or ABORT is issued. 

This is the block size, in words, of the file. 

This is the total number of blocks transferred to and 
from the file. The initial value is OD. 

This is the word index, relative to the base of the 
block, for the selected record within the block. This 
is applicable iff the file access is buffered. 

This bit signifies that the file has carriage control. 
I* is the same as the carriage control bit in 
ACBFOPTIONS if the file is spooled. If not spooled, 
the bit is zero, and IOMOVE will pass the FWRITE 
carriage control parameter directly to the driver 
rather than imbedding it as the first character of the 
output record. 

This is the CONTROL parameter from the last FWRITE. 
This value is pertinent iff the file was opened with 
carriage control. 

This is the buffer number (O-relative) containing the 
most recently referenced record. Applicable iff the 
file access is buffered. 

This is the logical device number of the file. For a 
disc file this is the logical device number of the 
first extent. 

This bit signifies that the file is to be accessed with 
default blocking. The bit is initialized from the 
FOPEH stateword STATE. It does not need to be in the 
ACB; it is mentioned here only to signify that the bit 
is effectively used due to the way ACBLSTATE is 
initialized from STATE. 

This is the file close disposition derived from the 
FOPEM call. The only way this can be specified is via 
a file equation. The legal values are the same as 
those for FCLOSE. 
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ACBDNTYPE This is the file reference format type number and is 
derived from the FOPEN call. The following are legal 
values : 

- full name 

1 - account name absent 

2 - group and account name absent 

3 - null name 

This information is needed by FRENAME. 

ACBDTYPE This is the device type number of the file. The 
following are legal values (octal): 

- moving head disc 

1 - fixed head disc 
7 - foreign disc 

10 - card reader 

11 - paper tape reader 
20 - terminal 

2k - card reader/interpreter/punch 

26 - SSLC 

27 - programmable controller 

30 - magnetic tape 

31 - serial disc 
1»0 - line printer 
Hi - card punch 

U2 - paper tape punch 
U3 - CALCOMP 500 plotter 
kh - CALCOMP 600 plotter 
1*5 - CALCOMP 700 plotter 

ACBEOF This bit is set when EOF has been sensed. 

ACBE0FS This is the type of EOF detected on $STDIN(X). This 
field consists of two bits: 

(0:1) - super colon (i.e. EOF for $STDIMX) 
(1:1) - regular colon (i.e. EOF for $STDIN) 

Applicable for multi-access to $STDIN(X) only. 

ACBERROR This is the error number for the file. It is used by 
all intrinsics except FOPEN. When an error is detected 
the error number is placed in this cell. The error 
number is cleared at the beginning of each callable 
intrinsic except FCHECK (which reads it). 

ACBFCB This is the FCB vector for the file. Applicable only 

to disc files. 
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ACBFKEYS 



ACBFNUM 

ACBFOPTIONS 
ACBFPTR 



ACBFMAVTX 



ACBGSTATE 



ACBGSTATDS 



ACBHI8LK 



This bit controls the definition of the fl and f2 
function keys on the 26UU page mode terminal; it is 
adjusted by FCONTROL(32) and FCONTROL ( 33 ) . (Obsolete 
function) 

File number, range from 1 to 255. Used mostly for 
calling routines that access things such as labels by 
file number. 

This is the FOPTIONS in effect for this file access. 

This is the sequential access record pointer; it 
contains the next sequential record number. The 
initial value is OD. This value is used only by the 
FREAD, FWRITE and FUPDATE intrinsics. However the 
value is maintained by all data transferring file 
system intrinsics. 

This is the entry index into the file multi-access 
vector table (FMAVT). This is valid iff the file 
access is multi-access. 

These are miscellaneous state flags. These are 
"global" in nature in that they are the same for all 
accessors in a multi-access environment. The 
constituent bits are described individually. 

This is the general part of the last I/O status for the 
file. The following are the legal values: 

- pending 

1 - successful 

2 - end of file 

3 - unusual condition 

k - irrecoverable error 

This is the highest block number for which an 

anticipatory read has been issued, and is applicable 

iff the file access is buffered. The initial value is 
-ID. 



ACBHIT 



ACBINHIBCRLF 



This is the buffer hit flag. If set it indicates that 
the last read or write request was serviced without any 
physical I/O required. This flag is used only for 
performance measurement. The code which manipulates it 
is optional to the file system, and is controlled by 
compiler toggle X3- 

This bit controls the termination of lines written to 
the terminal. If not set then each line is terminated 
with a CR and LF; if set then no line termination 
characters are used. This bit is valid iff the file is 
a terminal file; it is adjusted by FSETMODE. 
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ACBLIMECTL 



ACBLPCTL 
ACBLSTATE 



ACBMODE 



ACBMAME 



ACBNEWEOF 



ACBNOWAITEOF 



This is the line control bit. If net set then each 
line is post-spaced; if set then each line is 
pre-spaced. This bit is used by line printers and 
terminals only. It is adjusted by FCONTROL(l) and 
FWRITE with the appropriate carriage control. 



This are the line and 
described separately. 



page control bits, which are 



These are miscellaneous state flags. They are "local" 
in nature in that they may be different for each 
accessor in a multi-access environment. Bits (9:6) are 
initialized from the stateword local variable called 
STATE in FOPEN; the ten remaining bits are initialized 
individually. The constituent bits are described 
individually. 



These are miscellaneous mode flags, 
bits are described individually. 



The constituent 



This is the local file name. The name is 
in length with trailing blanks added. 



eight bytes 



This flag 
should be 



when 



set indicates that a new tape mark 
«,*«/«.*.« ^ written before the tape is rewound 
backspaced. Applicable only to mag tape files. 



or 



This bit is used to save the value of the local EOF 
advanced flag NEWEOF in IOMOVE between the I/O 
initiation and I/O completion calls. This flag is 
applicable iff the file is accessed in no -wait I/O 
mode. 



ACBNOWAITMODE 



This cell is used to save the I/O mode between no-wait 
I/O initiation and completion calls. If the bit is set 
then the last I/O request was a write; otherwise it was 
a read. This cell is pertinent iff the file is 
accessed in no-wait I/O mode. 



ACBMUMBUFS This is the number of buffers, less one, used for the 
file access. Applicable iff the file access is 
buffered. 

ACBPAGECTL This is the page control bit. If not set then a page 
is assumed to consist of 60 lines (auto page eject); if 
set then a page is assumed to consist of 66 lines (no 
auto page eject). This is used primarily for line 
printers but is also valid for terminals; these are the 
only devices for which this is valid. This bit is 
adjusted by FCONTROL(l) and FWRITE with the appropriate 
carriage control. 
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ACBPRIV 



ACBQSTATUS 



ACBQUIESCE 



ACBREADCODE 
ACBREADMODE 

ACBREADTYPE 

ACBRSIZE 
ACBRTFRCT 

ACBSAVEEOFS 

ACBSHCNT 

ACBSHCNTIN 



This flag when set indicates that the file is 
privileged in that it has a negative file code; the 
user must be in privileged mode to access it. 

This is the qualifying part of the last I/O status for 
the file. The values are unique for each general 
status part. See I/O System IMS for all legal values. 

This bit controls critical output verification. If 
set, buffered output is guaranteed to have been written 
to the device when control is returned to the user. 
This bit is adjusted by FSETMODE. 

This field consists of the input EOF checking type and 
mode, and is used to generate the PI parameter to 
ATTACHIO. These fields are described individually. 

This field controls the input EOF checking mode. It is 

00 for reading $STDIM, 01 for reading $STDINX, and 10 
for the command interpreter. 

This field controls the input EOF checking type. It is 

01 for JOBs, 10 for SESSIONS, and 00 for DATA. 

This is the file's record size in positive bytes. 

This is the total number of records transferred to and 
from the file. The initial value is 0D. 



This field is used to save the 
during BREAK mode processing. 



contents of ACBEOFS 



This is the total number of LACBs that exist for this 
PACB. Valid iff the file access is multi-access. 

This is the total number of input-only LACBs that exist 
for this PACB. Valid iff the file access is 
multi-access. 



ACBSHCKTS 



ACBSIZE 



ACBSPA0PT 



ACBSPFOPT 



This is the total LACB and total input-only LACB 
counts, each of which is described separately. 



This is the size, in words, of the complete ACB. 
includes the buffering extension, if present. 



It 



This is the A0PTI0NS for the spooled device. 
Applicable iff the file access is to a spooled device. 

This is the F0PTI0HS for the spooled device. 
Applicable iff the file access is to a spooled device. 
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ACBSPOOLED This is the spooled device flag. If set then the file 
access is to a spooled device. 

ACBSPOOLIO - This field is a combination of the spooled device flag 
and the input/output mode of the spooled device. Legal 
values are: 

00 - not spooled 

01 - illegal 

10 - input spooling 

11 - output spooling 

ACBSPREC This is the record size, in bytes, of the spooled 
device. Applicable iff the file access is to a spooled 
device. 

ACBSPTTFE This is the device type (from the LOT) of the spooled 
device. Applicable iff the file access is to a spooled 
device . 

ACBSPTYRC This cell contains the spooled device type and record 
size, which are described separately. 

ACBSPVDEV This is the logical device number of the spooled 
device. Applicable iff the file access is to a spooled 
device . 

ACBSPXDDX This is the index into the IDD or ODD for a spoolfile. 
Applicable iff the file access is to either a spooled 
device or a spoolfile. 

ACBSTATUS This is the last I/O status for the file. It conies 
from the I/O status part of the IOCB returned by 
ATTACHIO. Not all ATTACHIO calls update this cell. 

ACBSTOPCHAR This is the record termination character used for 
terminal reads. This character can be changed via 
FCONTROL(25). 

ACBSTREAM This bit signifies inter-block garbage for disc files. 
If set, the block size is a multiple of 128 words and 
therefore there is no garbage data between blocks. 
This fact is used to improve multi-record I/O by 
mapping the request into as few ATTACHIOs as possible. 
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ACBSUBCL 



This is the sub-class part of the device type number. 
The sub-class is unique for each access class. The 
following are the legal sub- class values for each 
device class: 



- direct 

- moving head disc 

1 - fixed head disc 
7 - foreign disc 

1 - serial input 

- card reader 

1 - paper tape reader 

2 - parallel input/output 

- terminal 

U - card reader/punch 

6 - SSLC 

7 - programmable controller 

3 - serial input/output 

- mag tape 
7 - serial disc 
h - serial output 

- line printer 

1 - card punch 

2 - paper tape punch 

3 - CALCOMP 500 plotter 
U - CALCOMP 600 plotter 
5 - CALCOMP 700 plotter 



ACBTAPEERROR 



ACBTBLOCK 



ACBTLOG 



This bit controls the reporting of recovered mag tape 
errors. If not set the recovered errors are not 
reported to the user; if set then recovered errors are 
reported to the user by returning CCL and error number 
39- Valid iff the file is a mag tape file. This bit 
is adjusted by FSETMODE. 

This bit controls block mode transfers on the 26UU page 
mode terminal. This bit is adjusted by FCONTROL(28) and 
FCONTROL(29). 

This is the last I/O transmission log for the file. It 
comes from the I/O transmission log part of the I0CB 
returned by ATTACHIO. Not all ATTACHIO calls update 
this cell. 



ACBVDADDR 



ACBXMITCRLF 



This is the volume table index for 
Applicable iff the file is a disc file. 



the file. 



This bit controls CR and LF insertion into the user 
buffer on the 26kk page mode terminal. This bit is 
adjusted by FCONTROL(30) and FC0NTR0L ( 31 ) . 



6-3U 



If present, the PACB buffering extension contains from one to sixteen 
block buffers each having the following format: 



12 



6 7 8 12 13 1U 15 
IOQ entry index 



W M P 



I0CB - Status 
IOCB - Transmission log 



Block number 



Block log. device no. | 

Block sector number 



Buffer 



BLKIOQX 

1 BLKFLAGW 

2 BLKLSTAT 

3 BLKTLOG 
U BLKBLOCK 

5 

6 BLKDADDR 

7 

8 BLKBUFFER 



Other identifiers used: 



BLKIOCB 

(BLKLDEV) 

BLKFLAGS 

BLKIOOUT 

BLKDIRTY 

BLKIOPEND 

BLKIOCOMP 

Discussion: 

BLKBLOCK 



BLKBUFFER 



= BLKDBL(1)#, 
= BLK(6).(0:8)#, 
= BLK(1).(13:3)# 
= BLK(1).(13:1)# 
= BLK(l).(lU:l)# 

= BLK(1).(15:1)# 
= BLK(l).(lU:2)# 



IOCB 

block logical device number 

block I/O flags 

last I/O was write? 

buffer modified? 

I/O in progress? 

I/O complete - not dirty 



BLKDADDR 



This is the block number of the data contained in the 
buffer. A value of -ID indicates that the buffer is 
empty. 

If ACB buffering is used, this is the buffer location. 
When system buffers were used, the buffer location was 
given by BLKSYSBUFX and BLKSYSBUFDISP. 

This is the block's logical device and sector number. 
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BLKDIRTY 



BLKFLAGS 



BLKIOCB 



BLKIOCOMP 



BLKIOOOT 

BLKIOPEHD 

BLKIOQX 

BLKLDEV 
BLKLSTAT 

BLKTLOG 



This flag is set if the contents of the buffer has been 
modified. When the block buffer is reused this flag is 
checked to see if the block needs to be written to the 
device . 



These are the miscellaneous flags associated 
block, which are described separately. 



with the 



This is the IOCB returned by the I/O system when the 
block I/O has completed. On a blocked I/O request this 
is. obtained from the ATTACHIO call; on an unblocked I/O 
request this is obtained from WAITFORIO. 

This is the buffer modified flag (BLKDIRTY) and the I/O 
in progress flag (BLKIOPEND), which are described 
separately. This field is usually interrogated to see 
if it contains the value 2, which means that the buffer 
has been modified but not yet written to the device. 



This is the mode of the I/O operation for the 
It is set by a write and cleared by a read. 



block. 



This is the I/O in progress flag. It is set if the I/O 
is pending; it is cleared when the I/O has completed. 

This is the IOQ index of the unblocked I/O request for 
the block. It is used as the argument to WAITFORIO, 
which insures the completion of the I/O request. 

This is the logical device number of the block. 

The I/O status part of the IOCB consists of the PCB 
number and the error code for the completed I/O 
request. 



The transmission log part of the IOCB is the number 
words or bytes transferred by the the I/O request. 



of 
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3.2.7 File Control Block (FCB) 



The FCB coordinates access to a file on a sharable device. At present 
the only sharable device is a disc, so only disc files have FCBs. 

The information contained in an FCB is derived from the file label. The 
FCB is used to hold this information, rather than the file label, since 
it can be accessed more quickly. 

The FCB can be contained in a stack when first created. If another 
process opens the file, the FCB will be moved to a system data segment 
(which will be created if it doesn't already exist) so that the first 
process* entire stack need not be present when the second process is 
dealing with the file. The number of a data segment containing a list 
of numbers of shared file system data segments is kept in system global 
location 1076 octal. The size of the FCB depends on the maximum number 
of extents specified at FOPEN; there are kk (octal) words plus two per 
extent. There will be at least one extent, since the file label always 
exists in the first extent. The FCB extent map is in terms of logical 
device and sector number. The extent map in the file label is in terms 
of volume rather than logical device; the map is converted by VTABTOLDEV 
when the label is read, and converted back by LDEVTOVTAB when the label 
is written to disk. 

The FCB has the following format: 



12 


3 7 8 12 13 lU 15 


1 1 1 


Complete FCB size | 


I New FCB vector j 


1 FOPTIONS | 


I Device specification | 


| Prev. lock' 


Dev. type | | Device subtype j 


I No. opens 


for output | No. opens for any mode | 


i Creator ACB vector j 


1 RIN number | 


I Exclusive status | 



1 FCBNEWFCBV 

2 FCBFOPTI0NS 

3 FCBDEVICE 
k 

5 

6 FCBACB 

7 FCBRIN 

10 FCBEXCLSTAT 
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Private volume information 


i 11 
12 

1 13 
I Ik 

! 15 

16 
17 
20 
21 
22 
23 
2k 

25 
26 
27 
30 
31 
32 
33 
3* 
35 
36 
37 
Uo 
kl 


FCBPVINFO 




File 


limit 






FCBFLIM 




Reserved 


for IMAGE 






FCBIMAGE 


End of data pointer 


FCBEOF 


No. user labels written 


I No. user labels 


avail. 


FCBUSERLBL 




Extent size 


in sectors 






FCBEXTSIZE 


Blocking factor 


| Sectors 


per block 




Sector offset to data 


| Disp | No. 


extents - 1 




Last extent s: 


.ze in sectors 


i 




FCBLASTEXT 
SIZE 






I No. opens 


input 


mode 


Group name 


- 1st char. 


I Group name 


- 2nd 


char. 


FCBGN 


Group name 


- 3rd char. 


| Group name 


- Uth 


char. 




Group name 


- 5th char. 


| Group name 


- 6th 


char. 




Group name 


- 7th char. 


1 Group name 


- 8th 


char. 




Acct name 


- 1st char. 


I Acct name 


- 2nd 


char. 


FCBAN 


Acct name 


- 3rd char. 


I Acct name 


- Uth 


char. 




Acct name 


- 5*b char. 


I Acct name 


- 6th 


char. 1 




Acct name 


- 7th char. 


I Acct name 


- 8th 


char. I 




Start of file block number 


FCBSTART 


Current number of data blocks in 


the file j 


FCBEND 
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| Number of open and close 
| Logical device number | 


records (message 
sector number 


file) | 




First extent 






1 • 1 


| Logical 


device number | 


sector number 






Last extent 





1*2 FCBNUMOPEN- 
CLSREC 

kk FCBEXTMAP 
U5 



Other identifiers used: 



FC6SIZE 

FCBLKST 

FCBDTYPE 

FCBSUBTYPE 

FCBOCHTODT 

FCBOCHT 

FCBLBLEOF 

FCBLBL 

FCBBLKFACT 

FCBSECTPBLK 

FCBSECTOFF 

FCBDISP 

FCBHUMEXTS 

FCBOCKTIH 

FCBLABEL 

FCBLDEV 



FCB.(2:lfc)#, 

FCB(U).(0:2)#, 

FCB(fc).(2:6)#, 

FCB(1*).(12:U)#, 

FCB(5).(0:8)#, 

FCB(5).(8:8)#, 

FCB(l6).(0:8)#, 

FCB(l6).(8:8)#, 

FCB(18).(0:8)#, 

FCB(18).(8:8)#, 

FCB(19).(0:8)#, 

FCB(19).(8:3)#, 

FCB(19).(11:5)#, 

FCB(21).(8:8)#, 

FCBDBL(l8)#, 

FCB(36).(0:8)#, 



size in words 
previous lock state 
device type 
device subtype 
no. accessors - output 
no. accessors 
no. labels written 
no. labels available 
blocking factor 
sectors per block 
sector offset to data 
pending disposition 
no. extents less 1 
no. acccessors - input 
label LDEV and sector 
label LDEV 



Discussion: 
FCBACB 

FCBAN 
FCBBLKFACT 



This is the vector of the ACB that was created at the 
same time as the FCB. This is used in conjunction with 
FCBNEWFCBV when relocating the FCB. 

This is the account name of the file. It is eight 
bytes in length with trailing blanks added. 

This is the blocking factor of the file. It is the 
number of logical records in a physical block. Legal 
values range from 1 to 255. 
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FCBDEVICE 



This specifies the device on which the file resides. 
If it is positive then it represents a logical device 
number; if negative it represents a (negative) device 
class index. 



FCBDISP 



This is the pending FCLOSE disposition for the file. 
Legal values are: 



FCBDTYPE 

FCBEND 
FCBEOF 



FCBEXCLSTAT 



FCBEXTMAP 



domain disposition 

- no change 

1 - save permanent 

2 - save temporary and rewind 

3 - save temporary but do not rewind 
U - release 

7 - invalid file (file label access error) 

This is the device type number of the first extent of 
the file. See ACBDTYPE for a list of legal values. 

Block number of the file's EOF, relative to FCBSTART. 

This is the end-of-file pointer for the file. It is a 
double integer representing the number of records in 
the file. It can also be viewed as the record number 
of the next record past EOF. 

This is the exclusive status of the file access. If -1 
then the file is being accessed exclusively; otherwise 
it is the number of semi-exclusive accessors. 

This is the extent map of the file. The number of 
extents is specified by FCBMUMEXTS; a OD extent 
descriptor indicates that the extent has not been 
allocated. 



FCBEXTSIZE 



FCBFLIM 



FCBFOPTIONS 
FCBGN 



This is the extent size, in sectors, of the file. All 
extents in the file except possibly the last have this 
size. This is a logical value, and legal values range 
from 1 to 65535 sectors. This restricts the maximum 
file size to 2097120 sectors (268,1*31,360 words). 

This is the end-of -space pointer for the file. It is a 
double word integer representing the maximum number of 
records (fixed length record format) or blocks 
(undefined or variable length record format) in the 
file. 

This is the FOPTIONS in effect for the file. 

This is the group name of the file. It is eight bytes 
long with trailing blanks added. 
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FCBLABEL 



FCBLASTEXTSIZE 



This is the logical device and sector number of the 
file label, which is the same as the first extent 
descriptor. 

This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the same 
as FCBEXTSIZE; otherwise this value may be different 
from FCBEXTSIZE. This is the size of the last physical 
extent for the file; it is not the size of the last 
allocated extent. 



FCBLBL 



This is the number of user labels allocated for the 
file. Since each label is a sector long, this is also 
the number of sectors allocated for user labels. 



FCBLBLEOF 



This is the end-of-data pointer for the user labels. 
It is analogous to FCBEOF in that it represents the 
number of labels written. The initial value is 0. 



FCBLDEV 



This is the logical device number of the first extent 
of the file. 



FCBLKST 



FCBNEWFCBV 



This is the previous lock state of the file and is 
derived from the file label. Legal values are: 

- no accessors 

1 - read 

2 - write 

3 - read/write 

This is the vector of the new FCB for the file. It is 
used in conjunction with FCBACB to move the FCB to a 
system (shared FCB) control block table when the second 
accessor is established. If this value is zero then 
there is no new FCB; if non-zero then a new FCB has 
been created. 



FCBNUMEXTS This is the maximum number of extents, less one, 
allowed for the file. It is not the number of extents 
presently allocated, which is always determined by 
counting non-zero entries in the extent map. 

FCBNUMOPENCLSREC Number of open and close records in the message file. 



FCBOCNT 



This is the number of accessors for the file. 
Alternatively it can be viewed as the number of PACBs 
created for the file. 



FCBOCNTIN This is the number of file accessors having input 
access . 

FCBOCNTOUT This is the number of file accessors having output 
access. 
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FCBRIN 



FCBSECTOFF 



FCBSECTPBLK 
FCBSIZE 

FCBSTART 

FCBSUBTYPE 
FCBUSERLBL 



This is the RIN number used to support dynamic locking 
(i.e. FLOCK and FUHLOCK) for the file. If there is no 
dynamic locking then this number is zero. 

This is the sector offset from the file label to the 
first block of the file. This is not necessarily equal 
to FCBLBL+1 since an integral number of blocks are 
allocated for the file and user labels. 

This is the number of sectors in a block for the file. 

This is the size, in words, of the complete FCB. It 
includes the extent map. 

Block number of the file's start, excluding the file 
label block. 

This is the device sub-type number of the first extent. 

This field describes the user labels for the file. It 
consists of FCBLBL and FCBLBLEOF, described separately. 
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3.3 File Label (FLAB) 



The file label has the following format: 



12 3 7 



8 12 13 14 15 



| File name - 1st char. | 


File name - 


2nd char. | 



1 
2 
3 
4 
5 
6 
7 

10 

11 

12 

13 

14 

15 

16 

17 

I 20 

1 21 

| 22 

1 23 

1 24 


FLLOCNAME 


j File name - 3rd char. | 


File name - 


4th char. | 




I File name - 5th char. | 


File name - 


6th char. | 




j File name - 7th char. | 


File name - 


8th char. | 




| Group name - 1st char. 


Group name - 


2nd char. 


FLGRPNAME 


I Group name - 3rd char. 


Group anme - 


4th char. 




j Group name - 5th char. 


Group name - 


6th char. 




I Group name - 7th char. 


Group name - 


8th char. 




j Acct name - 1st char. 


Acct name - 


2nd char. 


FLACCTNAUE 


j Acct name - 3rd char. 


Acct name - 


4th char. 




j Acct name - 5th char. 


Acct name - 


6th char. 




j Acct name - 7th char. 


Acct name - 


8th char. 




j Creator name - 1st char. 


Creator name 


- 2nd char. 


FLUSERID 


j Creator name - 3rd char. 


Creator name 


- 4th char. 




j Creator name - 5th char. 


Creator name 


- 6th char. 




j Creator name - 7th char. 


Creator name 


- 8th char. 




j Lockword - 1st char. 


! Lockword - 


2nd char. 


FLLOCKWORD 


j Lockword - 3rd char. 


| Lockword - 


4th char. 




j Lockword - 5th char. 


| Lockword - 


6th char. 




j Lockword - 7th char. 


| Lockword - 


8th char. 




j Securit 


y matrix 




FLSECMX 
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Reserved 



| SR 



Creation date 



Last access date 
Last modification date 



File code 
FCB vector 



S | R | L | X | Subtype | Disc type | R/W 
No. user labels written | No. user labels avail. 



File limit in blocks 



Checksum 
Cold load ID 



FOPTIONS 
Record size in bytes 



Block size in words 
Sector offset | | No. extents -1 



Last extent size in sectors 
Extent size in sectors 



End of data pointer 



1 25 




1 26 




| 27 


FLCREATE 


1 30 


FLLASTACC 


1 31 


FLLASTMOD 


1 32 


FLFILECODE 


1 33 


FLFCBVECT 


i 34 


FLLOCK 


1 35 


FLUSERLBL 


I 36 


FLFLIM 


1 37 




1 40 




1 41 




1 42 


FLCHECKSUM 


1 43 


FLCLID 


1 44 


FLFOPTIONS 


1 45 


FLRECSIZE 


1 46 


FLBLKSIZE 


1 47 




1 50 


FLLASTEXT- 




SIZE 


1 51 


FLEXTSIZE 


1 52 


FLEOF 


1 53 
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I Volume table index | 




| 1st extent sector number 




| • 


j Volume table index | 




I Last extent sector number 




1 


1 File allocation time 


I File allocation date 


1 


1 Start of file block number 


| Block number of end of file 


| Number of open and close records (mes 


sage file) 


I Device name - 1st char. | Device name 


- 2nd char. 


I Device name - 3rd char. | Device name 


- Uth char. 


| Device name - 5th char. | Device name 


- 6th char. 


| Device name - 7th char, j Device name 


- 8th char. 



5U FLEXTMAP 
55 



15U FLALLOCTINE 

155 

156 FLALLOCDATE 

160 FLSTART 

161 

162 FLEHD 

163 

16k FLNUMOPENCLSREC 

165 
17k FLDEVNAME 

175 
176 

1177 



Other identifiers used: 



FLSECURE = FLAB(22).(15:1)#, 
(FLSRRELEASE)= FLAB(22) . (lU:l)#, 
(FLSTORE) = FLAB(28).(0:1)#, 
FLRESTORE = FLAB(28) . (1:1)#, 



file secure bit 
STORE/RESTORE released bit 
file being stored 
file being restored 
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(FLLOAD) 

FLEXCL 

FLSR 

FLSRL 

(FLSRLX) 

FLSUBTYPE 

FLDTYPE 

FLSTATUS 

(FLLBLEOF) 

(FLLBL) 

FLSECTOFF 

FLNUMEXTS 

FLLABEL 

FLVTAB 



FLAB(28).(2:1)#, file loaded 

FLAB(28) . (3:1)#, exclusive access 

FLAB(28).(0:2)#, S & R bits 

FLAB(28).(0:3)#, S, R, & L bits 

FLAB(28).(0:10#, S, R, L, 4 X bits 

FLAB(28).(U:1*)#, device sub-type 

FLAB(28).(8:6)#, device type 

FLAB(28).(lU:2)#, write/read status 

FLAB(29).(0:8)#, no. labels written 

FLAB(29).(8:8)#, no. labels available 

FLAB(39)-(0:8)#, sector offset to data 

FLAB(39)-(11:5)#, no. extents less 1 

FLABDBL(22)#, label VTAB and sector 

FLAB(M0.(0:8)#, label VTAB index 



Discussion: 
FLACCTNAHE 

FLALLOCDATE 
FLALLOCTIME 

FLBLKSIZE 
FLCKECXSUH 



FLCLID 



FLCREATE 



FLDEVNAME 



FLDTYPE 



This is the account name of the file. It is eight 
bytes in length with trailing blanks added. 

Date that the file was allocated on this system. 

Doubleword containing the time that the file was 
allocated on this system. 

This is the block size, in sectors, of the file. 

This is the exclusive-OR checksum of the file label 
(excluding words 3U, U2, and 1*3 octal) and is used for 
error detection. Each time the file label is read from 
disc the check sum is calculated and compared against 
the value recorded in the file label. Similarly, each 
time the file label is written to the disc the check 
sum is calculated and inserted into the file label. 

This is the cold load number in effect the last time 
that the file was accessed. This should always be the 
current cold load number. If it is not it means that 
the system crashed while the file was open and that the 
data in the file label should be "reset" (principally 
the FCB vector FLFCBVECT) . 



This is the creation date of the file. It 
format defined by the intrinsic CALENDAR. 



is in the 



This is the FOPEN device specification that was used 
when the file was created. This information is needed 
when new extents are allocated. 

This is the device type number of the first extent of 
the file; see ACBDTYPE for a list of legal values. 
This value is determined by configuration. 
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FLEND 



FLEOF 



FLEXCL 



FLEXTMAP 



FLEXTSIZE 



FLFCBVECT 
FLFILECODE 



Number of current data blocks (that is, the end of file 
block number relative to the start of file). 

This is the end-of-file pointer for the file. It is a 
double word integer representing the number of records 
in the file. It can also be viewed as the record 
number of the next record past EOF. 

This is the exclusive access flag for the file. If set 
it means that the file has been opened exclusively by a 
single accessor. If not set then the file is 
potentially accessible by others. 

This is the extent map of the file. The number of 
extents is specified by FLNUMEXTS; a OD extent 
descriptor indicates that the extent has not been 
allocated. 

This is the extent size, in sectors, of the file. All 
extents in the file, except the last, have this extent 
size. This is a logical value, and legal values range 
from 1 to 65535 sectors. This limits the maximum file 
size to 2097120 sectors. 

If non-zero, this is the vector of the FCB for the 
file. If zero, the file is not being accessed. 

This is the file code of the file. Known values are: 



-U01 IMAGE data set 

-U00 IMAGE root file 

1021* USL file 

1025 BASIC data file 

1026 BASIC program file 

1027 BASIC fast program file 

1028 RL file 

1029 Program file 

1030 STAR file 

1031 SL file 

10U0 Cross Loader ASCII file (SAVE) 

lOUl Cross Loader relocatable binary file 

10U2 Cross Loader ASCII file (DISPLAY) 

1050 EDITOR KEEPQ file (non-COBOL) 

1051 EDITOR KEEPQ file (COBOL) 
1060 RJE punch file 

1069 RSAM (Bob Strand's ISAM) file 

1070 QUERY procedure file 

1071 QUERY work file 

1072 QUERY work file 
1080 KSAM key file 
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FLFLIM 



FLFOPTIONS 
FLGRPNAME 

FLLABEL 

FLLASTACC 

FLLASTMOD 

FLLASTEXTSIZE 



FLLBL 



FLLBLEOF 



FLLOAD 



FLLOCK 



FLLOCKWORD 



1081 
to 

1089 
8000 

to 
8099 



Reserved for KSAM 



Reserved for APL 



This is the end-of -space pointer for the file. It is a 
double integer representing the maximum number of 
records (fixed length record format) or blocks 
(undefined or variable length record format) in the 
file. 



This is the FOPTIONS of the file. 

This is the group name of the file. 
long with trailing blanks added. 



It is eight bytes 



This is the volume table index and sector number of the 

file label, which is the same as the first extent 

descriptor. 

This is the last access date of the file. It is in the 

format defined by the intrinsic CALENDAR. 



This is the last modification date of the file. It 
in the format defined by the intrinsic CALENDAR. 



is 



This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the same 
as FLEXTSIZE; if the file has more than one extent then 
this value may be different from FLEXTSIZE. This is 
the size of the last physical extent for the file; it 
is not the size of the last allocated extent. 

This is the number of user labels allocated for the 
file. Since each label is a sector long, this is also 
the number of sectors allocated for user labels . 

This is the end-of -data pointer for the user labels. 
It is analogous to FLEOF in that it represents the 
number of labels written. 

This is the LOADED flag for the file. If set it means 
that the file is a loaded program or SL file and cannot 
be modified except by a privileged accessor. This flag 
is set and cleared by the loader, not the file system. 

This identifies the word containing the lock bits, 
which are described separately. 

This is the lock word of the file. It is eight bytes 
long with trailing blanks added. If it is all blanks 
then the file does not have a lockword. 
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FLLOCNAME 



FLNUMEXTS 



This is the local name of the file. 
long with trailing blanks added. 



It is eight bytes 



This is the number of extents, less one, allowed for 
the file. It is not the number of extents allocated. 
Legal values range from to 31, i. e., 1 to 32 
extents . 



FLNUMOPENCLSREC Number of open and close records in the message file. 
FLRECSIZE This is the record size of the file in negative bytes. 



FLRESTORE 



FLSECMX 



FLSECTOFF 



FLSECURE 



FLSR 



This is the RESTORE flag for the file. If set it means 
that the file is being RESTOREd and cannot be accessed. 
RESTORE also sets the STORE bit for the file (FLSTORE) ; 
see FLSR for a full description of the use of these 
bits. This flag is set and cleared by STORE/RESTORE, 
not the file system. 

This is the security matrix of the file. 
The bits are organized into five groups of six bits 
each. (Bits 0:2 are not used.) The groups correspond 
to the access types: READ, APPEND, WRITE, LOCK, and 
EXECUTE. Within each group, each bit specifies who 
may have the access: ANT, ACCOUNT MGR, ACCOUNT LIB- 
RARIAN, GROUP, GROUP LIBRARIAN, CREATOR. 

This is the sector offset from the file label to the 
first block of the file. This is not necessarily equal 
to FLLBL+1 since an integral number of blocks are 
allocated for the file and user labels. 

This is the file security enforcement flag for the 
file. If not set then the file has been RELEASEd and 
the security matrix FLSECMX should be ignored. If set 
then secured as specified by the security matrix. 

This is the STORE and RESTORE flags for the file, which 
are described separately. STORE and RESTORE decode the 
two-bit field to indicate their operation. Legal 
values are: 

- file not in use by either STORE or RESTORE 

1 - illegal value 

2 - file being STOREd 

3 - file being RESTOREd 

The file system interprets the leftmost bit as 
indicating that the file is being accessed by either 
STORE or RESTORE. The rightmost bit is interpreted as 
indicating what access should be permitted: (file 
being STOREd) allows read access; 1 (file being 
RESTOREd) allows no access. This field is set and 
reset by STORE /RESTORE, not the file system. 
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FLSRL 

FLSRLX 

FLSRRELEASE 



FLSTART 



FLSTATUS 



FLSTORE 



FLSUBTYPE 



FLUSERID 



FLUSERLBL 



FLVTAB 



This is the STORE, RESTORE and LOADED flags for the 
file, which are described separately. 



This is the STORE, RESTORE, LOADED and exclusive 
for the file, which are described separately. 



flags 



This flag is used by STORE /RESTORE. If a file is 
STOREd with the ";RELEASE" keyword, STORE will set this 
flag in the tape copy of the file label. RESTORE will 
allow any user to access such files , regardless of the 
file's normal security. If this bit is off in the tape 
copy of the file label, RESTORE applies normal security 
checks (as defined by the information in FLSECNK and 
FLSECURE). This bit is zero for files on disc. 



Block number of the file's start, 
label block. 



excluding the file 



This is the read/write status of the file. Legal 
values are: 

- no accessors 

1 - read 

2 - write 

3 - read/write 

This is the STORE/RESTORE flag for the file. If set it 
means that the file is being either STOREd or RESTOREd. 
The RESTORE bit (FLRESTORE) must be interrogated to 
determine which operation is taking place; see FLSR for 
a full description of the use of these bits. This flag 
is set and cleared by STORE /RESTORE, not the file 
system. 

This is the device sub-type number of the first extent 
of the file. This value is determined by 
configuration. 



This is the creating user name of the file, 
eight bytes long with trailing blanks added. 



It is 



This field describes the user labels of the file. It 
consists of FLLBL and FLLBLEOF, which are described 
separately. 



This is the volume table index of the first 
the file. 



extent of 
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3.U File Hulti-Access Vector Table (FMAVT) 



(SIR %20) 



The FMAVT points to the shared PACB for files opened multi-access. It 
occupies its own data segment (DST 5U octal). Its entry format is: 






12 3 6 7 8 


12 13 


11* 


15 


1 1 


G I D | | 


JIT DST 








Logical Device | 










Disk Address 




1 PACB Vector | 





1 

2 
3 



Since spoolfiles are multi-access, they will have entries in the FMAVT. 
Disk files and spool files have the disk address in words 1 and 2, and 
bit D is 0. For device files, the disk address is zero and bit D is 1. 
Unused entries have word all zeroes. Bit G is set on for global 
multi-access. This allows multi-access between jobs.' 



3*5 System Global Area (S7SGL0B) 



The file system uses several words in the system global area for its own 
use. 



SHFCBDST 

MONITOR 

MAXSSECT 

NUMSSECT 

EXTSSECT 

SPOOLINDEX 

CSIOWAIT 

CCLOSEPLABL 

DSCHKPLABL 

DSOPENPLABL 

DSCLOSEPLABL 

SDSLDEVLABEL 

MANWCPLABL 



SYSDB+J&76, shared FCB DST no. 

SYSDB+%77, monitoring flag word 

SYSDB+%100, max # spoolfile sectors 

SYSDB+%102, current # spoolfile sectors 

SYSDB+%10U, # sectors/spoolfile extent 

SYSDB+%132, class spool index 

SYSDB+%135, CSIOWAIT PLABEL 

SYSDB+%lU0, CS CCLOSE PLABEL - FPROCTERM 

SYSDB+%335. DSCHECK PLABEL 

SYSDB+%336, DSOPEN PLABEL 

SYSDB+%337, DSCLOSE PLABEL 

SYSDB+%323, PLABEL for SDSLDEV 

SYSDB+foto; MANAGEWRITECONV PLABEL 
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3.6 SIRa, Locks, and Deadlocks 



The file system uses two SIRs: the File SIR, which is intended to 
protect file label integrity, and the FMAVT SIR, which is to guarantee 
the integrity of the FMAVT. Since the file system locks these 
resources , and also locks control blocks , deadlocks can occur if locking 
is done in the wrong order. Not only must the file system handle 
locking correctly, but the entire ensemble of the file system, its 
callers, and its callees must do so also. These include KSAM, which has 
a SIR of its own, and SYSDUMP and STORE, which lock the File SIR because 
they tweak bits in file labels. The presently accepted order is: 

Get FMAVT SIR 
Lock ACB 
Get File SIR 
Lock FCB 

It may not be necessary to do all of these things in any particular 
procedure. In modifying a procedure, you should be sure that any of 
these locks which you change are consistent not only within your own 
code, but also with its callers and callees. 
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CHAPTER 7 PROCESS TABLES 



7.1 Introduction 

The operating system maintains state, control, and accounting information 
on each process. The data structures for this purpose are the process con- 
trol block table (PCB; core resident, 1 entry per process) and the process 
control block extension (PCBX; contained in the process* stack below DL). 
Process related information which must be accessible even when the process' 
stack is not present in main memory is maintained in the process* PCB 
entry. All other process related information is maintained in the process' 
PCBX. 

A process is identified in the system by its PCB entry number, referred to 
as its PIN (process identification number), or by its PCBPT=(PIM)*(PCB 
entry size). 

The structure of the PCB table, PCB entry format, PCBX structure, and PCBX 
format are specified in this chapter. 

7.2 Process Control Block Table Structure and Format 

7.2.1 Fixed Cells Related to PCB 

3 Absolute address of base of PCB table 
U Absolute address of current process' PCB entry 
%1003 Sysbase relative address ov PCB table base 
%1271 Sysbase relative address of head of dispatching queue's PCB 

entry 
%1272 Sysbase relative address of tail of dispatching queue's PCB 
entry 
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7.2.2 PCB Entry Format 



o| 


# OF CONFIGURED ENTRIES 


n 


ENTRY LENGTH (%20) 


2| 


# OF UNASSIGNED ENTRIES 


31 


TABLE RELATIVE INDEX TO FIRST UNASSIGNED ENTRY 


**| 





51 





6| 





71 





81 





91 





10 1 





111 





12 1 





131 





1U| 





151 
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7-2.3 Unas signed PCB Entry Format 



o| 




JilOOOOO 


1| TABLE 


RELATIVE 


INDEX TO NEXT UNASSIGNED ENTRY 


21 







31 







1*1 







51 







6| 







71 







8| 







91 







10 1 







ill 







12 1 







131 







1U| 


151 
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7.2.3 Assigned PCB Entry Format 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



PCB00 



PCB01 



PCB02 

PCB03 

PCB04 

PCB05 
PCB06 
PCB07 

PCB08 



PCB09 

PCB10 
PCB11 
PCB12 
PCB13 



.,__, __|-_, -,. 



I--I-I--I--I--I--I 



S |B |C |H |P |H |I |P |li |L |S |T |U |H 

A |F |R |S |I |S |P |C |P |W |N |R |S |I 

R I |I |I |0 |P |E | | | | |W |E |P 

I |T |R |V |R |X | | | I I ID |R 

I I I |R U IP I I I I I IQ II 



I- 

IR 
U 
|T 
IB 
IK 



SYSBASE RELATIVE ADDRESS OF PROCESS' SEGMENT 
LOCALITY LIST 



A | 
D | 
B I 



XDS 



DST# 



I 

| RESERVED 



A| 
0| 



STK 



DST# 



C| RESERVED 



| | | | B | | U| J| T| III S| | I| S| T| M 

M| R| R| M| I| I| C| N| I| S| 0|FA| M| I| I| E 
| G| L| A| 0| 0| P| K| M| G| N| | P| R| M| M 



FATHER'S PIN 
NEXT BROTHER'S PIN 



SON'S PIN 
BLKIDX 



PIMP PIN 



I 



BPTLINK 



PSIM 



L | BMS 

I I 
V | 



OA 



I D| | 

I E|F | 

I A|A | 

I D|C | 

I I I 



NIMPPIN 



PPC |S | PTYPE | |HK|SK|ST|HB|CY|BK 
10 | I I I I I I I 
IV | I I I I I I I 



EVENT FLAGS |WS 

SEGIDENTIFIER OF LAST REF. SWAPPABLE SEGMENT 
CSTX BLOCK MAP INDEX 



D |L |C 

I IQ I 

S I I 

P I I 

Q I I 



ID |E |I |C 

I I IN |0 

I I IT |R 

I I IE |E 

I I IR IR 



PRIORITY 



RESABORTINFO 



SLLPTR 



DBXDSINFO 

STKINFO 

HAKEMASK 

FATHERSONINFO 
| BROTHERINFO 
PIMPINBREAKLINK 

PIINFONIMPPIN 



PROCSTATE 

EVENTFLAGS 
LASTREFSWAPSEG 
PBX 
QUEUEINGINFO 
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PCB14I SYSBASE INDEX OF NEXT PCB ENTRY IN QUEUE | NQPTR 
, 1 

PCB15 | SYSBASE INDEX OF PREVIOUS PCB ENTRY IN QUEUE | PQPTR 
, 1 

7.2.4 PCB Assigned Entry Field Descriptions 



PCBOO .(0:1) 

.(1:1) 

•(2:1) 

.(3:1) 

.(4:1) 

.(5:1) 

.(6:1) 

•(7:1) 

•(8:1) 

.(9:1) 

.(10:1) 

.(11:1) 

.(12:1) 

•(13:1) 

.(14:1) 

.(15:1) 

PCB01 .(0:16) 



SAR ==> scheduling attention required 

Bounds Flag — Priv mode bounds check 

CRIT ==> process is critical 

HSIR ==> process has a sir 

PIOVR ==> pending PI, process critical 

HSPRI ==> hold sir priority 

IPEXP ==> incore protect expired 

PC ==> prempt capability 

MP ==> must preempt 

LW ==> long wait 

SW ==> short wait 

TRW ==> terminal read wait 

USEDQ ==> used a quantum since transaction began 

HIPRI ==> hold impeded priority 

Reserved. 

RITBK 

SLLPTR, SYSBASE relative index to process' segment 
locality list 



PCB02 .(0:1) ADB, set if db pointing to an absolute address 

.(1:10) XDS, DST entry number of extra data seg. to which 

DB is set; zero if none. 

.(11:4) Reserved for expansion of DST entry number field 

PCB03 .(0:1) STOVRALL FLAG ==> stack overflow is already allocated 

.(1:10) DST entry number of process' stack 

.(11:1) SC, set if executing system code 

.(12:3) Reserved 
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PCB (CONT.) 








PCBOU 


.(0:1) 


M, mourning wait. 






.(1:1) 


RG, global RIN wait. 






.(2:1) 


RL, local RIN wait. 






•(3:1) 


MA, mail wait. 






• (^D 


BIO, blocked I/O wait. 






.(5:1) 


10, I/O wait. 






•(6:1) 


UCP, UCOP wait and RIT wait. 






•(7:1) 


JNK, junk wait. 






.(8:1) 


TIM, timer wait. 






•(9:1) 


MSG, file system basic ipc message wait. 






.(10:1) 


SON, son wait. 






.(11:1) 


FA, father wait. 






.(12:1) 


IMP, process waiting to be unimpeded. 






.(13:1) 


SIR, process waiting for a sir. 






.(lU:l) 


TIM, process waiting for a time out. 






.(15:1) 


MEM, process waiting for memory. 




PCB05 


.(0:8) 


FPIN, father's PCB entry number 






.(8:8) 


SPIN, son's PCB entry number 




PCB06 


.(0:8) 


BPIN, brother's PCB entry number 






.(8:8) 


BLKIDX (reserved) 




PCB07 


.(0:8) 


PIMPPIN, previous impeded pin. 






.(8:8) 


BPTLINK, breakpoint link for process. 




PCB08 


.(0:3) 


PSIM, pseudo - interrupt mode 








1 


: hard kill 








2 


: soft kill 








3 


: stop 








14 


: hibernate 








5 


: escape 








6 


: break 








7 


: normal 






•(3:1) 


Reserved for future use. 






.(U:2) 


OA 








0: 


other source 








1: 


father 








2: 


son 








3: 


reply done on RIT wait 






•(6:1) 


DEAD, set during expiration. 






•(7:1) 


FAC, if set, the father is to be activated on process 






termination. 






.(8:8) 


NIM 


PPIN, next impeded process' pin 
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PCB (CONT.) 



PCB09 .(0:1) 
.(1:2) 



PCB10 



•(3:2) 



(5:1) 
(6:3) 



(9:1) 

(10:1) 

(11:1) 

(12:1) 

(13:1) 

(H:l) 

(15:1) 

(0:15) 
(15:1) 



PCB11 .(0:16) 



LIVE, set if process is alive. 
BMS, block mail, valid if MA set 

0: sent to father 

1: rec from father 

2: send to son 

3: rec from son 
PPC, process to process communication, set with 
respect to son. 

0: null 

1: son to father 

2: father to son 

3 : blocked 
ST0V, stack overflow bit 
PTYPE, process type 



user 

user, son of main 

user, main 

user, main, task 

system 

system, UC0P 



0: 

1: 

2: 

3: 

4: 

5: 

6: 

7: 
Reserved. 

HK, hard kill pseudo interrupt 
SK, soft kill pseudo interrupt 
ST, stop pseudo interrupt 
HB, hibernate pseudo interrupt 
CY, control-y pseudo interrupt 
BK, break pseudo interrupt 

EVENTFLAGS, one for each wait class in PCB04 
WS, wake up waiting switch set if an awake is 
missing. 

LASTREFSWAPSEG, segment identifier of last 
referenced swappable code segment. 



PCB12 .(0:16) PBX, CSTX block map index of process' program. 

PCB13 (QUEUEING INFO) 

.(0:1) DISPQ ==> on dispatching queue 

.(1:1) L scheduling class 

.(2:1) C scheduling class 

.(3:1) D scheduling class 

.(4:1) E scheduling class 

.(5:1) INTER ==> process is interactive 

.(6:1) CORER ==> process is core resident 

.(7:1) Reserved. 

.(8:8) Process' scheduling priority 
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PCBlU .(0:16) NQPTR, sysbase index of PCB entry of next process in schedul- 
ing queue 

PCB15 .(0:16) PQPTR, sysbase index of PCB entry of previos process in 
scheduling queue 
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7-3 PCBX Structure and Format 

7.3.1 PCBX General Structure 



a-- 


->| 
->| 

->| 

->| 

-> 1 

-> 1 


DL-a 
DB-a 


- SEG. REL DL VALUE 
= SEG> REL DB VALUE 








b— 


c-b 


= PXFIXED LENGTH 










PXFIXED EXPANSION AREA 
BIT MAP 
(U words) 






PXFIXED EXPANSION 


c— 


d-c = PXFILE LENGTH 










1 
PXFILE EXPANSION/CONTRACTION 

1 
1 


d— 


COUNT 
FOR 


OF SECTORS ALLOCATED 
PXFIXED EXPANSION 






DL-c 






DL-b 






DL-a 


DL- 






DB- 







I 

PXGLOB 
I 



PXFIXED 



PXFILE 



I 
PCBX 
SIZE 

I 

I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 



I 

I 

1 
1 

\ / 
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7.3-2 PXGLOB FORMAT 

The PXGLOB portion of the pcbx is for job information, and contains the 
same job related information for all processes belonging to the same job. 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
~|~|--|--|-|--|--|--|-|_-|_.|__|„,„|__|__| 



DL-a=SEG. REL DL VALUE 
DB-a=SEG, REL DB VALUE 



II 

I 

12 



USER ATTRIBUTES 



— - 1 

I ACTUAL JOB INPUT LDM |3 



JHAT INDEX 



I 

JPCNTINDEX(RelByteAddr) | ACTUAL JOB OUTPUT LDN |U 

— -I 



STACK DUMP FLAGS | 



JDT DST INDEX 



//I R| TT | D| I| 
JCUT INDEX 



JIT DST INDEX 



16 
I 



i«« 



IIY 



Muumiin 



R * restart bit 
I = job in/list interactive 
D 3 job in/list duplicative 
TY * job type 

* undefined 

1 ■ session 

2 » job 

3 ■ task 

* ■ reserved: 



Stack Dump Flags 

Bit = Armed 

Bit 1 = Suppress ASCII 

Bit 2 * Suppress traceback 

Bit 3 ■ Q-63 to S 

Bit k = QINIT to S 

Bit 5 * DL to QINIT 
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7.3-3 PXFIXED ASSIGNMENTS 

The PXFIXED portion of the pcbx contains specific information and control 
information. 



oi 


c-d PXFIXED SIZE j 


ii 


RELATIVE S(S-DB) I 


2| 


RELATIVE Z(Z-DB) j 


31 


INITIAL Q(Q-DB) | 


U| 


INITIAL RELATIVE DL (DB-DL) 


51 


GENERAL RESOURCE CAPABILITY (FROM PROG-FILE) | 


61 


RESERVED |MATlMLT|MST|MCY| 


71 


LINK TO XDS ENTRIES IN EXPANSION AREA| XDS CNT | 


10 1 


P| S| EXTRA DATA SEGMENT DST INDEX 1 


111 


P| S| EXTRA DATA SEGMENT DST INDEX j 


12 1 


P| S| EXTRA DATA SEGMENT DST INDEX | 


131 


P| S| EXTRA DATA SEGMENT DST INDEX 


l*»l 


X| A| ABORT Y |RW| INITIAL CST INDEX 


15 


MAXIMUM STACK SIZE(MAXDATA LIMIT) 


16 


ARITHMETIC TRAP MASK 


17 


ARITHMETIC TRAP PLABEL 


20 


LIBRARY TRAP PLABEL 


21 


| SYSTEM TRAP PLABEL 


22 


| CONTROL Y PLABEL 


23 


| JOB | 

JTYPE j JOB# 


2U 


| ACTUAL SIZE OF VIRTUAL SPACE ALLOCATED TO STACK 


25 


| USER ABORT PLABEL 


26 


|U |L | C|///////////|A | LOAD PROCEDURE I.D. 


27 


j CUR. MAX STACK SIZE (largest value ever for Z-DL) 



Trap Modes 

5 ,MAT(12:1)-Arith. 
.MLT(13:1)-Library 

6 .MST(lU:l)-Systera 
.MCY(15:1)-Ctl-Y 

7 (XDS CNT- 12: U) 



8 



10 / 0:1 RESERVED FOR 

| CST EXPANSION 

11 | 1:1 ■ 1 IF ABORT 

j IN PROGRESS 

12 < 7:1 ■ IF HAVE R/W 
| ACCESS TO 

13 j PROG FILE 

j = 1 OTHERWISE 
1U j 8:8 = CST # OF SEG 

I INITIALLYEXECUTED 
AT PROC CREATION 



15 \ 
16 



17 

18 

JOB TYPE: 
l=SESSION 
19 2=J0B 

20 

21 

U user udcs exist 

22 L logging 

A acct udcs exist 

23 C process shares clock 

1 => clock shared 
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(reserved) 



PXFIXED (CONT.) 



30 
31 
32 
33 
3b 

35 
36 
37 
bo 
bl 
b2 
b3 
bb 

b5 
b6 

b7 
50 
51 
52 
53 
5b 
55 
56 
57 
60 



PROCESS CPU TIME 
(MSEC) 



MAXIMUM DATA SEG SIZE USED (IN SECTORS) 



TOTAL VIRTUAL STORAGE USED (IN SECTORS) 



CURRENT EXTRA DATA SEGMENT SPACE 



MAXIMUM EXTRA DATA SEGMENT SPACE 



iiiiiiiiiuiuiuiiiun 



STOV COUNT 



PROCESS EXECUTION TIME REMAINDER (IN MSEC) 



SET TO-1 WHEN IN BREAK MODE* 



CONTINUE FLAG (: CONTINUE COMMAND)** 



IMAGE PLABL 



ERROR LEVEL 



INTRINSIC ERRORS 



INTRINSIC ERRORS 



INTRINSIC ERRORS 



INTRINSIC ERRORS 



INTRINSIC ERRORS 



INTRINSIC ERRORS 



TSLR, virtual time since last rescheduled 



TSTB, virtual time since transaction began 



TSSWAPIN, virtual time since swapin 



TSLA, virtual time since last absence 



TSLD, virtual time since last deallocation 



QCNT, quantums used since transaction began 



RESERVED 



1 2b 

125 

126 
127 
128 

29 
30 

31 
32 
33 
3b 
35 
36 
37 
38 

39 
bO 
bl 
jb2 

|b3 
|bb 

Ib5 

|b6 

b7 

Ib8 
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61 
62 
63 
6k 

65 
66 

67 
70 
71 
72 
73 
7k 

75 
76 

77 



RESERVED 

# LAUNCHES 

# SL FAULTS 

# PCB FAULTS 

# DATA SEG FAULTS 

# BLOCKED DISC I/O's ISSUED 

# UNBLOCKED DISC I/O's REQUESTED 

# UNBLOCKED DISC I/O's WAITED ON 

# IMPEDES (SUBSYSTEM ) 

# IMPEDES (SYSTEM) 

# SIR BLOCKS 
/////////////////////////////////////////////// 
/////////////////////////////////////////////// 

RESERVED 
RESERVED 



PCLASSMASK 
PROCQUESTOPWORD 



100 1 
i 
I — 

101 { 

I — 
102| 

I 
1031 

I 

NOTES: P = if opened by priv user 
S = 1 if data seg is sharable 



PROCSTOPTIME 



k9 
50 
51 
52 
53 
5U 
55 
56 
57 
58 
58 
60 
61 
62 

63 
6k 

65 
66 

67 



PCLASSMASK = BIT MASK OF CLASSES THIS PROCESS HAS ENABLED 
PROCQUESTOPWORD. (0:1*) = PROCESS PRIORITY: 7 => L QUEUE 

6 => C QUEUE 
2 => D QUEUE 
1 => E QUEUE 
. (U:12)= REASON STOPPED: 1 => STOP SEG FAULT 

2 => STOP DISC WAIT 

3 => BLOCKED I/O, NON TERMINAL 
k => TERMINAL READ 

5 => STOP IMPEDE 

6 => STOP ACTIVE 
PROCSTOPTIME = DBL WORD TIMESTAMP OF WHEN PROCESS STOPPED FOR 

REASON GIVEN IN PROCQUESTOPWORD 
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* SET TO COMMAHD RECORD LENGTH WHEN COMMAND PENDING 
(I.E. COMMAND ENTERED DURING BREAK OR ENCOUNTERED 
DURING FLUSHING) . 

** CONTINUE FLAG VALUES 

= NO CONTINUE IN EFFECT 

1 = CONTINUE JUST ENCOUNTERED 

2 = CONTINUE IN EFFECT FOR THIS COMMAND 
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7.3.U PXFIXED EXPANSION BITMAP 

The PXFIXED bitmap and expansion area is for use in accounting of extra 
data segments acquired by the process. 

File System Section of PCBX (PXFILE) 



The PXFILE area is a sub-section of the PCBX. It is a contiguous, expandable 
and contractable block of storage that is managed by the file system primarily 
for its own use. Other sybsys terns, namely CS and DS, also make use of the 
PXFILE section. In doing so they must conform to the conventions of the file 
system. 

The overall structure of the PXFILE area is: 



OVERHEAD 



CONTROL BLOCK 
TABLE 



AVAILABLE 



AVAILABLE FILE 
TABLE 



(fixed) 



(variable) 



(variable) 



(variable) 



VECTOR FORMAT 

o 56 



15 



ENTRY 



I 



DST NUMBER 
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Overhead (PXFILE) 



The part labeled OVERHEAD contains information that is 
pertinent to the entire table. 



1 7 8 15 

PXFILE SIZE IN WORDS 
LAST DOPEN ERROR NUMBER | LAST COPEN ERROR NUMBER 
I 

LAST DF AFT | SLAVE AFT NUMBER 

LAST KOPEN ERROR NUMBER | LAST FOPEN ERROR NUMBER 

AFT SIZE IN WORDS 
CS TRACE FILE INFO 
LAST RESPONDING NO-WAIT I/O AFT ENTRY NUMBER 
1st USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
2nd USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
3rd USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
Uth USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
5th USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
6th USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
7th USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 
8th USER (NOCB) CONTROL BLOCK TABLE DST NUMBER 





1 
2 
3 
k 

5 
6 

7 



8 

9 

10 

11 

12 
13 
lit 

15 



In general the following identifiers are used when referring 
to this part of the PXFILE area: 
DEFINE 

PXFSIZE = PXFILEf, «PXFILE SIZE» 
PXDSOPENERR = PXFILE(l) . (0:8)#,«LAST DOPEN ERROR CODE» 
PXCOPENER = PXFILE(1).(8:8)#,«LAST COPEN ERROR CODE» 
PXFNOCB = FXFILE(2).(0:1)#,«NO CB'S IN PXFILE CBT?» 
PXLASTDSAFT = PXFILE(3) . (0:8)#,«DSNUM OF LAST DS OPEN» 
PXSLAVEAFT = PXFILE(3) . (8:8)#,«DSNUM OF SLAVE PTOP DS0PEN» 
PXFKOPEN = PXFILE(l4).(0:8}#,«LAST KOPEN ERROR C0DE» 
PXFFOPEN = PXFILE(i4).(8:8)#,«LAST FOPEN ERROR C0DE» 
PXFAFTSIZE = PXFILE(5)#, «AFT SIZE IN WORDS» 
IXFCTRINFO = PXFILE(6)#, «CS TRACE FILE INFO» 
OVERHEAD (CONT. ) 
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PXFLEFTOFF 

FXFCBT1 

PXFCBT2 

PXFCBT3 

PSFCBTU 

PXFCET5 

PXFCBT6 

PXFCET7 

PXFCBT8 



PXFILE(7)#. 
PXFILE(8)#, 
PXFILE(9)#, 
PXFILE(10)# 
PXFILE(ll)# 
PXFILE(12)# 
PXFILE(13)# 
PXFILE(ll4)# 
PXFILE(15)# 



<<LAST RESPONDING AFT NR.» 
<<1ST USER CBT DST NR.>> 
<< 2ND USER CBT DST NR.» 
«3RD USER CBT DST NR.» 
<<UTH USER CBT DST NR.>> 
<<5TH USER CBT DST NR.>> 
<<6TH USER CBT DST NR.>> 
<<7TH USER CBT DST NR.» 
«8TH USER CBT DST NR.>> 



The following is an alphabetized list of the above identifiers 
along with a discussion of their meaning. 

PXFAFTSIZE 

This is the size (in words) of the Available File Table. Note 
that the size is in words and not in terms of number of 
entries. The reason for this is that it simplifies the 
calculation for the size of the available block. 

PXFCBT1-8 

These are the DST numbers of the user (NOCB) control block 
tables. A DST number of indicates that no data segment is 
allocated. Note that a DST number is representable with ten 
bits; a full word is used to simplify the code. 

PXFCOPEN 

This contains the last COPEN error number. It is not used by 

the file system; it is included here for completeness only. 



PXFCTRINFO 

This contains information pertinent to the CS trace file, 
is not used by the file system; it is included here for 
completeness only. 



It 



PXFDOPEN 

This contains the last DOPEN error number. It is not used by 

the file system; it is included here for completeness only. 

PXFDSINFO 

This cell is reserved for DS. It is not used by the file 

system; it is included here for completeness only. 

PXFFOPEN 

This contains the last FOPEN error number. If it is zero then 
the last FOPEN completed successfully; if it is non-zero then 
the last FOPEN completed unsuccessfully and the number 
represents the file system error number. Note that only eight 
bits are needed to hold the error number; a full word is used 
to simplify the code. 
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OVERHEAD (COOT. ) 



PXFKOPEN 

This contains the last "KOPEN" error number. Since KSAM is 
imbedded in the file system, an FOPEN failure on a KSAM file 
can be caused by a failure to open either the key file or 
the data file. This error number is used in conjunction with 
PXFFOPEN to determine which file caused the KSAM open failure. 
Note that this error number is not used by the file system; 
it is included here for completeness only. 

PXFLEFTOFF 

This is the AFT entry number of the last file/line that 

completed a no-wait I/O; if zero then no no-wait I/O has 

been completed. This cell is maintained solely by and for the 

IOWAIT intrinsic. 

PXFNOCB 

This bit is used to signify that no control blocks are to be created in the 
PXFILE control block table. This bit is set by the NOCB parameter to the CPTAIE 
intrinsic or the :RUN command. The reason for this feature is to permit the 
3000/20 user to have as much stack space as possible; otherwise the MPS/30 file 
system will take away several hundred words of stack for the PXFILE control 
block table. 

PXFSIZE 

This is the size (in words) of the complete PXFILE area. It 
is the sum of the overhead block, the control block tab .3, the 
available file table and the available block. 
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Control Block Table (PXFILE) 



The part labeled CONTROL BLOCK TABLE contains a file control 
block table. This is a new feature with MPE/30; it is not 
present under MPE/20. 

The format of the control block table is the same as any other file control 
block table. The only difference is that addressing is slightly more compli- 
cated since the table does not begin at DB+0. As a result all pointers within 
the table are table relative; the starting address of the table must be added to 
a pointer to generate a final DB-relative address. This addressing convention 
is consistently applied to all file control block tables. When the control 
block table is expanded, space is taken from 

the AVAILABLE area. If no space is available then the PXFILE 
area is expanded and the acquired space is added to the 
AVAILABLE area. 

The interested reader is referred to section 3.2 of chapter 6 
for a more detailed description of file control block tables. 

15 



TABLE SIZE IN WORDS 



16 
17 
18 
19 
20 
21 



DST NUMBER CONTAINING TABLE 
VECTOR TABLE SIZE IN WORDS 



LOCK WORD 
IMPEDED QUEUE 



VECTOR TABLE 



CONTROL BLOCK AREA 



In general the following identifiers are used when referring 

to this part of the PXFILE area: 

DEFINE 

PXFCBTAB = PXFILE(l6)#, <<C0NTR0L BLOCK TABLE» 

PXFCBTSIZE = PXFILE(l6)#, <<TABLE SIZE IN W0RDS» 

CONTROL BLOCK TABLE (CONT.) 
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rXFrsrx = F:ffiLE(i7!f, << table dst *umber>> 

PXFVTSIIE = PXFILE(l8).#, << VECTOR TABLE SIZE IN WORDS>> 

PXFLOCX = PXFILE(19)#, <«TABLE LOCK WORD>> 

PXFQUEVE = PXFILE ( 20) #, <<TA3LE IMPEDED QUEUE » 

PXFVT = PXFILE(21)#; <<VECTOR TABLE>> 



The following is an alphabetized list of the above identifiers 
along with a discussion of their meaning. 

PXFCBTAB 

This is the first word of the control block table. In general 

this is used only when referring to the entire control block 

table. 

PXFCBTSIZE 

This is the size in words of the control block table. In 
general this is used only when calculating the size of the 
available block. 

PXFDSTX 

This is the DST number of the data segment that contains the 
control block table. This is the same as the DST number of 
the stack. Note that the convention of referring to the DST 
number of the stack as zero is not used. The reason for this 
is that the file system may refer to a PXFILE control block 
table in another stack. This would result in an ambiguity 
since that PXFILE control block table would also have a DST 
number of zero. 

PXFLOCK 

This is the lock word for the table and has the same format as 

the lock word for a control block in the table. 

PXFQUEUE 

This is the impeded queue for the table and has the same format 

as the impeded queue for a control block in the table. 

PXFVT 

This is the first word of the vector table. It is used when 

referring to the vector table in general. 

PXFVTSIZE 

This is the size, in words, of the vector table. Note that 
this is the length of the table and does not reflect the number 
of entries used or unused. 



Available Block (PXFILE) 



The part labeled AVAILABLE BLOCK is used to provide space when 
the Control Block Table or the Available File Table is 
expanded. These two tables grow towards each other, and when 
■ore space is needed it is simply taken from the Available 
Block. 

When the Available Block is exhausted, the PXFILE area is 
expanded, the AFT is relocated and the new space is added to 
the Available Block. 

Note that currently the PXFILE area is only expanded; it is 
never contracted. 



Available File Table, AFT (PXFILE) 



The part labeled AVAILABLE FILE TABLE contains information 
used by the file system (or CS, DS, etc.) to grossly 
characterize the file access and, most importantly, to give 
the location of the control blocks. 

The overall structure of the AFT is: 



ENTRY If 



(fixed) 



EHTRY 1 



(fixed) 



where N = PXFAFTSIZE/U. 

The AFT is as long as specified by PXFAFTSIZE. Unused entries 
are all zero ' s . When the table is full it is expanded by 
taking space from the AVAILABLE block. 

The AFT is negatively indexed by file number: the entry at 
DL-8 corresponds to file number 1, the entry at DL-12 
corresponds to file number 2, etc. 
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AFT (COMT.) 

The structure of an AFT entry is: 
1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 



| ENTRY TYPE 


I N | | 

II 1 


1 PHYSICAL ACB VECTOR | 


1 LOGICAL ACB VECTOR | 


1 NO- WAIT I/O IOQX | 



1 

2 

3 



Note that the entry format is dependent on the entry type. The 
one shown above is the one used by the file system. 

In general the following identifiers are used when referring to 
an AFT entry: 



DEFINE 






AFTTYPE 


= AFT.(0:U)#, 


<<ENTRY TYPE>> 


AFTNULL 


= AFT.(U:1)#, 


«$NULL FILE» 


AFTPACBV 


* AFT(1)#, 


<<PACB VECTOR >> 


AFTLACBV 


= AFT(2)#, 


<<LACB VECTOR >> 


AFTIOQX 


■ AFT(3)#; 


<<NO-WAIT I/O IOQX» 
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AFT (CONT.) 



The following is an alphabetized list of the above identifiers 
along with a discussion of their meaning. 

AFTIOQX 

This is the IOQ index of the pending no-wait I/O (if any). 
Note that this is applicable iff the file was opened with the 
NOWAIT option specified. Also, CS and DS have the same 
capability and use this cell in a consistent manner. The 
reason for this is that the IOWAIT intrinsic services the file 
system as well as CS and DS, and is the principal user of this 
cell. If the cell is zero then there is no I/O pending; 
otherwise the cell contains the IOQ index corresponding to the 
pending I/O. 

Exception: a nonzero value for message files specifies the accesors 
reply port ( instead of an IOQ entry) . 

AFTLACBV 

This is the vector of the Logical ACB (LACB) (if any). Note 
that this is applicable iff the file was opened with the 
multi-access option specified. 

AFTNULL 

This bit signifies that the file is $NULL and that there are no 

control blocks. 

AFTPACBV 

This is the vector of the Physical ACB (PACB). Note that a PACB 

exists for all files except $NULL. 

AFTTTPE 

This is the AFT entry type number. At present the following 

entry types are defined: 

- file system 

1 - remote file 

2 - DS (no-wait I/O disallowed) 

3 - DS (no-wait I/O allowed) 
U - CS 

5 - CS (AUTO DIAL) 

6 - ESAM 

7 - 3270 

8 - message file 
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PCBX FOR CORE RESIDENT SYSTEM PROCESS STACKS 



0| DL-a (Seq Rel DL Value) |0 | 


1 1 | 
1| DB-a (Seq Rel DB Value) |1 j 


1 1 | 
2| USER ATTRIBUTES (always -1) |2 | 


1 -_-._.., 1 | 
31 | INPUT DEV LDEV |3 I 


U| j OUTPUT DEV LDEV JU | 


51 15 1 


6| | D| I| |6 | 


71 17 1 
10| PXFIXED SIZE (c-b) |8 | 


111 RELATIVE S (S-DB) |9 | 


12| RELATIVE Z (Z-DB) |10 | 


131 INITIAL Q (Q-DB) |11 | 


lk\ RELATIVE DL (DB-DL) |12 PXFIXED 


151 GENERAL RESOURCE CAPABILITY (-1) j 13 j 


16| RESERVED \lk | 


171 |15 | 


20 | DL-c |16 | 


21 1 DL-b j 17 j 


22 | DL-a |18 



NOTES: 1. there is no PXFILE area. 

2. the PXFIXED area is much smaller than a normal PCBX. 
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PROCESS TO PROCESS COMMUNICATION TABLE 



This table is used as the conmunication link by which father and son 
processes communicate with one another via the mailbox scheme. This 
table contains two words per entry and is indexed by PCBf (entry index 
is Meaningless). Each two word entry of index N essentially relates 
where, as well as how much, mail may be found for a process N with respect 
to communications between N and his father process. 



ENTRY FORMAT 



I - 

word | WORD COUNT 

I 

word 1 | MAIL WORD OR DST# 

I 



where word = the # of mail words to 
be transferred, 
word 1 - the only word of mail 
itself if word 0=1 

otherwise 
it contains the DSTf of 
the extra data segment 
where "word count" words 
of mail exist. 



NOTE: Assume process S is the son of process F. Then the process to 

process communication table index which will be used for mailbox communi- 
cation between son S and father F will be that of the son (i.e. S). 
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SUB-SYSTEM RESERVED DL AREA 



REMAINING DL AREA 



DB-12| 
DB-111 
DB-101 
DB-71 
DB-6| 
DB-51 
DB-i»| 
DB-31 
DB-2| 
DB-ll 



RESERVED FOR SORT/MERGE 
RESERVED FOR TRACE & TOOLBOX 
EXTERNAL PLABEL OF OUTER BLOCK 



DB ADDRESS OF STLT 
RESERVED FOR COBOL 
RESERVED FOR COBOL 
RESERVED FOR COBOL 
RESERVED FOR FORMATTER & PASCAL 
DB ADDRESS OF FLUT 



I 

IDB-10 
I 
IDB-9 



RESERVED FOR TRACE & SYMBOLIC DEBUG 



|DB-8 
■I 

IDB-7 
•I 

IDB-6 

I 

IDB-5 

I 

|DB-1* 

I 

lDB-3 

I 

IDB-2 

I 
IDB-1 



DB AREA 
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FORTRAN LOGICAL UNIT TABLE (FLUT) 



The segmenter is responsible for the preparation and initialization 
of a Fortran logical unit table. This is done when a program is 
prepared if that program contains at least one program unit that 
references a logical unit. The location of the FLUT is in the 
secondary DB area and the address of this location is contained in DB-1. 

The FLUT is formatted as per the following example: 



DB-1 | X 

DB+X | 3 I 
I M 
15 10 
17 10 
|10 | 
12551/// 



I I 



I 

1st BYTE 
List of the logical unit numbers 
referred to in this Fortran- 
produced program. 
(255 terminates). 

0123U5678 



l-l-l-l-l-l-l 



I 

2nd BYTE 
The HFE file number (as returned 
by FOPEN) used in accessing the 
file. Zero if file not open. 
Filled in by formatter as each 
l.u. is initially referenced. 
9 10 11 12 13 lU 15 
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CORE-RESIDENT 



JOB 

PROCESS 
COUNT 
TABLE 



ENTRY- 
RUNNING 
JOB 



. INDEX 



CO 
I 



JOB 

CUTOFF 

TABLE 



ENTRY/ 
CPU LIMITED 
JOB 



JOB TABLES (GENERAL) 



JOB 

MASTER 

TABLE 



SYSTEM JOB 

MONITORING 

INFO 



ENTRY'JOB 



RUNNING 
JOB/SESSION/TASK 



INDEX 



r 



MAIN PROCESS 
PCBX 



GLOB 



IIFCPULIMITEDI 



FIXED 



JOB GLOBAL 



PROCESS: 
ACCTG/ 
REG'RS/X DSTS 



PROCESS 



1> FILE 

SEGMENTS 
<PFS) 



SON OF MAIN PCBX 



(IF CPU LIMITED) 



-> PROCESS 

-►FILE 

_^ SEGMENTS 



{IF CPU LIMITED) 







1 Ct 

1 O 

1 CD 




JIT 


t i-3 
t > 
I w 


DST„ 


JOB 

INFORMATION 

TABLE 


1 f 




t w 




1 w 






1 o 
« < 
« tn 


k 


PROCESS. 




FIXED ACCTG 
FILE ACCTG 
J BIN/ 
REQ FCB/ACB 


1 < 

1 1-4 

1 w 

1 £! 



JDT 



JOB 

DIRECTORY 

TABLE 



JOB TEMP LIKE 
FILE INFO 
XDST NAMES 



DST 



*■ PROCESS 
-♦ FILE 
_Jj> SEGMENTS 



I O 



) 


ffi 


1 


> 


1 


H3 


1 


t-3 


1 


W 


1 


W 


1 




1 


op 



1 


C-l 


1 


O 


t 


LTJ 


t 


H 


t 


> 


t 


DO 


» 


t" 1 


t 


m 


1 


w 



JMAT - JOB MASTER TABLE STRUCTURE 



SIR = 15(10) = %17 
BST = 25(10) = %31 



0123l»5678 9101112131U15 



10 
11 
12 
13 
1U 

15 

16 

31 
32 



ZEROTH 
ENTRY 
I 
I 
I 
I 



MAXSIZE 



CURSIZE 



VMOUNT INFO 



ENTRY SIZE 



ENTRY POINTER 



SCHEDULING HEAD POINTER 



SCHEDULING TAIL POINTER 



TY| 



SCOUNTER 



TY| 



JCOUNTER 



LG I SEC I ////////////////JOBFENCE 



SLIMIT 



SNUM 



JLIMIT 



JNUH 

i::s:::3xi:s3:ssz:sss:3t:ttss:r 



WORKAREA 
(lfcWDS) 



max JMAT size (words/128) 
current JMAT size (words /128) 

1 : VMOUNT state saved for WARMSTARTs 
JMAT entry size (26) 

2 DB pointer to first entry (26) 

3 DB pointer to word of head 
entry in scheduling queue 

U DB pointer to word of tail 
entry in scheduling queue 

5 next assignable session #, TY=1 

6 next assignable batch #, TY=2 



8 

9 

10 

11 

12 

13 
Ik 

25 
26 



LG=1, logoff in progress 
SEC=0,high;=3,low JOBSECURITY 
maximum number sessions C E 

\ U X 
current number sessions | R E 

I R C 
maximum f batch jobs > E U 

I N T 
current # batch jobs j T I 

/ L N 
Y G 
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JMAT (GOUT.) 



ENTRY 1 



631 



151 



I 
I 
v 



| LAST 
I ENTRY 



SCHEDULING QUEUE 

WAITING SESSIONS 

FIFO WITHIN HIFRI/INPUT PRIORITY 
[ERROR JOBS ] 
[ FIFO ] 
WAITING JOBS 

FIFO WITHIN HIPRI/INPUT PRIORITY 
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JMAT - Job Master Table Entry 



2 
3 
k 

5 

6 

7 

10 

11 

12' 
13 
Ik 

15 

16 
17 
20 

21 

22 

23 

2k 
25 

26 

27 
30 
31 



111111 
0|1:2:3H»:5:6|7:8:9|0:1:2|3:U:5 



state :D|I:G:A|U:C: INPRI 
ty: job/session number 



user name 



account name 



job name 



group logon name 



JIN device : JLIST device 
Julian date (CALENDAR) 
time (CLOCK) 



main pin : XPRI 
CPU lim. (0 deflt, -1 no lim.) 



S|R:N:FT :0UTPRI : NUMCOPIES 
ORIGJIN : ORIGJLIST 



0|1:2:3|»»:5:6|7:8:9|0:1:2|3:U:5 

111111 

S = ORIGJIN is spooled. 
R = RESTART 
N = SEQUENCED 



2 

3 

U 

5 

6 
7 
8 
9 

10 
11 
12 
13 

Ik 
15 
16 

17 
18 

19 

20 

21 

22 

23 
2k 

25 



state 

■ free entry 

1 = introduced, in 

STARTDEVICE 
%k0 * waiting, job in 

scheduling queue 
%60 = initial, UCOP 

has created JSMP 

2 = executing, JSMP 

finished initial. 

3 = terminating. 
k = suspended. 

D = duplicative 

I ■ interactive 

{G = group password 

{(QUIET mode, if state»2) 

{A » account password 

(U = user password 

{0 * password validated (STARTDEVICE) 

(1 ■ must validate 

{ password (INITJSMP) 



C = JLIST is device 
class index 



ty = 1 - session 
2 - job 



ORIGJIN/ORIGJLIST is 

used as a scheduling 

link by UCOP (state* 

%k0). DB rel. ptr. to 

next entry. Last entry 

in list contains 0. 

FT ■ funny terminal 

00 - regular term. 

01 - regular term. , 

special logon 

10 - APL term. 

11 - APL term. 
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JOB STATES 



JOB STATES - JMAT ENTRY WORD 0.(0:6) 

SHOWJOB - Displays job states by scanning JMAT DST (%31) 

LOGON USES ALL STATES EXCEPT "SUSPEND" 



| STATE 
1 NO. 


STATE 1 
NAME 


PROCESS 


SEGMENT 


PROCEDURE(S) | 


1 1 


INTRO 


DEVREC 

JSMP 

SPOOLER 


NURSERY 


STARTDEVICE ->PUTJMAT | 
->ALLOCENTRY IN SEGMENT j 
ALLOCUTIL | 


| %U0 


WAIT 


DEVREC 
JSMP 

SPOOLER 


NURSERY 

\ 
SPOOLING 

/ 


STARTDEVICE - >SCHEDULE JOB | 
SPOOLSTUFFIN - >SCHEDULE JOB | 


1 %6o 


INIT- 
IALIZAT- 
ION 


UCOP 


UCOP 


LAUNCHJOB | 


1 2 


EXEC 


JSMP 


NURSERY 


INITJSMP | 


1 3 


TERMIN- 
| ATING 


JSMP 


MORQUE 


TERMINATE ->EXPIRE -> | 
CLEANUPJOB | 


1 o 


| FREE 
ENTRY 


JSMP 


I MORQUE 


TERMINATE ->EXPIRE -> | 
| CLEANUPJOB ->DEALLOCENTRY j 
I IN ALLOCUTIL j 



| k I SUSP 



JSMP | OPLOW | CXBREAKJOB 



For states INTRO and WAIT, 

DEVREC ~> logon command originated on terminal or 
other unspooled device. 

SPOOLER => logon command originated on spooled device. 

JSMP => logon command is the result of the execution of 
a : STREAM command. (This also includes USER 
processes which have done programmatic : STREAMS.) 
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JPCNT - JOB PROCESS COUNT TABLE 



(1 Entry /Running Job) 



CORE RESIDENT 



-BYTE- 





I MAXI 


A 

1 
| 




1 

1 
j 


1 25U (*376) 


MAXI 
t 


1 <%0) 


1 
1 
1 

1 

V 


- 




) 255 (%377) 




| GLOBAL RIN 
I FLAG TABLE 



SYSGLOB BASE = DB+13(%15) 
DST = 2l»(10) 
SIR = 13(10) 



< maximum # of running jobs (# of bytes-3) 

< total number of free entries 



-free entry 
-allocated entry 



•free list terminator 



A JPCNT entry must be allocated before the main process can be 
procreated. 

The job SIR (PXGJSIR) = some base+ JPCNT index. 



NOTE: This table is completely byte oriented with each entry 

consisting of one byte. Entries are taken from available pool 
on a "first found" basis. 25U (376 octal) in a byte denotes a 
free entry. 255 (377 octal) denotes the end of table. 

GLOBAL RIN FLAG TABLE 



This table is a bit table which immediately follows the "free list 
terminator" byte. It is initialized to and is indexed by JPCNT 
index for each job. When any process in a job/session locks a global 
rin, the appropriate bit is turned on. 
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JCUT - JOB CUTOFF TABLE 



1 Entry/ CPU- limited Job 



CORE RESIDENT 



SYSGLOB BASE = DB+11(%13) 
DST = 36(10) 
SIR = lU(10) 

SYSGLOB + %117 = default 
CPU tine limit for jobs 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 



.|„|..|..|..|__|..|..|..|..|..,„,..| 



FREE BEAD 



# OF REAL ENTRIES | ENTRY SIZE (3) 
POINTER TO LAST ENTRY (0) 



HEADER ENTRY 



JCUTCPUL 



JCUTCPUC 



TYPICAL ENTRY 

tine limit 
(seconds) 

time count 
(msec) 



POINTER TO NEXT FREE ENTRY (END OF LIST = 0) 



LAST ENTRY 



FREE ENTRY 
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JIT -Job Information Table 





1111 
0|1:2:3|1<:5:6|7:8:9|0:1:2|3 


1 1 
U:5 





not used - 


1 


6 : JIT DST 


2 


pointer to job info 


8 


3 


pointer to acct info 


k& 


k 


pointer to reserved area 


59 


5 


association table index 


6 

7 


not used 


10 


7 


11 


ty : job number 


12 


JITKAXP : JITMPN 


13 


EOF: not used 


lli 


DS DATASEG 


15 


JITASEC 


16 
17 


JITGSEC 
group security 



JIT DST is word 6 in PXGLOB 



20 
21 
22 
23 

2k 

25 

26 

27 

30 
31 
32 

33 



JITHAN 
account name 



JITHGN 
home group 



JITLGN 
log -on group 




1 
2 

3 
k 

5 

6 
7 

8 

9 
10 
11 

12 

13 

Ik 

15 

16 
17 
18 

19 

20 
21 
22 
23 

2k 

25 

26 
27 



ty - 1 = Session 
2 = Job 



JITMAXP - MAXJOBPRI capability 

JITMPN - Job main PIN. 

JITE0F - used by FGLOSE to tell CI 
that a $STDIN(X) file was closed 
w/out encountering an EOF. 
(0:1)=$STDIN, (1:1)=$STDINX 



0|l:2:3l 1 *:5:6|7:8:9l0:l:2|3: 1 t:5 

111111 
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JIT - Continued 



111111 

0|l:2:3|U:5:6|7:8:9|0:l:2|3:l*:5 
I — I 

3M |28 

351 JITUH |29 

36 I user name | 30 

371 131 

, 1 

40 1 pointer to JITAIP 53 j 32 

I " - I 

4l|P|M: pointer to JITGIP 55 j 33 

. ! 1 

42| LATTR 1 3I4 

43 j local attributes 35 

I I 

44 1 PASSF j 36 

45 j passed file pointer | 37 

46| UCAP |38 

471 user capability * J39 

! 1 

50| |Uo 

51 1 allow mask Jul 

52| |U2 

I I 

531 local RIM pointer ji»3 

I I 

5M |U4 

551 JITJN jU5 

56 1 job name \U6 

571 |U7 

I i 

+ + 

0|1:2:3|4:5:6|7:8:9| 0:1:2 |3:4:5 

111111 



P - Group's home volume is 
a private volume 

M - Private volume mounted 
(i.e. group bound to home 
volume set), JITGIP = 57 



For bit mask definitions, see 
Allow mask format, Chapter 1. 
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JIT - Continued 





0|1 


2 


1111 
3l»t:5:6|7:8:9|0:l:2|3 


1 1 
^:5 


U8 

^9 

50 
51 

52 

53 
5h 

55 
56 

57 
58 

59 
60 




60 


3 


Accounting Info 


61 


JITCREC - # of creations 




62 
63 


JITCPUC 
cpu milliseconds 




61+ 


not used : HIPRI 


HIPRI - highest job pri 


65 
66 



JITAIP 




67 
70 



JITGIP 


System volume set 


71 
72 


: MVTABX 
JITGIP 


Mounted private volume set 


73 


1 




7U 









Oil 


2 


3|lt:5:6|7:8:9|0:l:2|3 
1111 


U:5 
1 1 





* THE FORMAT FOR UCAP (%U6-U7) IS AS FOLLOWS: 



W0RD1 

WORD2 






11 


2| 


31 


M 


51 


1 

6| 71 8| 9U0|ll|l2|l3|ll*|i5l 


SM 


AM|AL|GL|DI|OP|CV|UV|LG| 


i 

|CS|ND|SF| 

1 














|BA|IAIPM| 


1 

|MR| |DS]PH| 
_.. I 



JDT - JOB DIRECTORY TABLE 



I 



| MAX SEG SIZE(WDS) | 



POINTER TO JDSD 



POINTER TO JTFD 



POINTER TO JFEQ 



I 



JDSD 



JOB DATA 
SEGMENT DIRECTORY 



I 



I- 

1 I 
I- 

2 I 
I" 

3 I 
I " "I 

h | POINTER TO JLEQ | 

I — I 

5 | POINTER TO JJCW | 

I " I 

6 IPOINTER TO FREE SPACE | 

I - I 

I I 

WORK AREA 
15 words 



JDSJNUM |TY| NUM | 

I I 

I III II III I II I JSMPIN | 
I I 

I I 



1 entry per job 
DST # in PXGLOB 



job number 

main process number 



JTFD 



JFEQ 



JLEQ 



JOB TEMPORARY 
FILE DIRECTORY 



JOB FILE 
EQUATION TABLE 



JOB LINE 
EQUATION TABLE 



JOB CONTROL WORD 
TABLE (JJCW) 



FREE SPACE 



ENTRY 
SIZE 


INAME 
(WDS)j SIZE (WDS) 


CI 


| C2 




CN 


1 (%U0) 



ENTRY 
INFORMATION 



The name is a 

concatenation of up to 3 subnames. 
Bit of the 1st character of each 
subname is 1. 
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JOB DATA SEGMENT DIRECTORY ENTRY - (IN JDT) 



l 2 3 1* 5 6 7 8 9 10 11 12 13 1U 15 



U I 1 
SEGMENT ID 



EXTRA DATA SEQffiNT DST INDEX 
# OF PROCESSES ACCESSING 



JOB TEMPORARY FILE ENTRY - (IN JDT) 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

I ENTRY SIZE (WORDS) | NAME SIZE (WORDS) I 
I "-I 



NAME-ACTUAL FILE DESIGNATOR 

VOLUME POINTER | 

I 

FILE LABEL POINTER 



Name is a 

concatenation of up 
to three subnames. 
Bit of the first 
character of each 
subnarae is 1. 
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I 



FILE EQUATION TABLE ENTRY - (IN JDT) 



1 2 3 U 5 6 7 8 9 10 11 12 13 l*» 15 
ENTRY SIZE (WORDS) | NAME SIZE (WORDS) | 



NAME 
(FORMAL DESIGNATOR) 



PMASK 



NAME LENGTH (BYTES) | DEVICE LENGTH (BYTES) | 
- " I 



NAME-ACTUAL DESIGNATOR 
(may not be present) 



DEVICE/CLASS NAME 
(may not be present) 



FOPTIONS | * 

- - I 

AOPTIONS | * 

1 

#BUFFERS | INIT ALLOC |D |T |S |<- 

I 

RECORD SIZE | 



# EXTENTS 



I //////// I 
FILE 



BLOCK FACTOR 



-disposition 
BIT13 DEL 
BITlU TEMP 
BIT15 SAVE 



SIZE 
FILE CODE 



OUTPRI | NUMCOPIES | 

REF COUNT | f OF USER LABELS 



LENGTH FORMS=/LABEL= 



FORMS/LABEL 
ARRAY 
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JOB LINE EQUATION ENTRY 




1 
2 

3 
k 

5 
6 

7 
10 
11 
12 

13 
Ik 

15 
16 
17 
20 
21 
22 

23 

2U 



ENTRY SIZE (WORDS) | DESIG. SIZE (WORDS) 



FORMAL 
LINE DESIGNATOR 



(1-U WORDS) 




PHASK1 


REF CNT 5|P | 


PMASK2 


NAME LENGTH | 


DEV LENGTH 



NAME 



( END OF LEQ ENTRY IF NON- BLANK ) 



DEVICE 



PMASK3 



DRIVER NAME LENGTH 



DRIVER NAME 



LIST PNTR 



COPTIONS 



AOPTIONS 



DOPTIONS 



1 P=FLAG 
2 

3 
k 

5 
6 

8 

9 

10 

11 

12 

13 
1U 

15 
16 

17 
18 

19 

20 
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JLEQ ENTRY (CONT.) 









25 


NUMBER OF BUFFERS 


21 


26 


BUFFER SIZE IN WORDS 


22 


27 
30 


INSPEED 


23 
2U 


31 
32 


OUTSPEED 


25 
26 


33 


POLL REPEAT 


27 


3U 


POLL DELAY 


28 


35 


C TRACE INFO 


29 


36 


LOCAL ID PNTR 


30 \ 


37 


REMOTE ID PNTR 


31 1 


Uo 


SUPLIST PNTR 


32 | REL TO ORIG 

j OF LEQ ENTRY 

33 1 


kl 


PHONE LIST PNTR 


k2 


POLLIST PNTR 


3U | 


U3 


MISC ARRAY PNTR 


35 / 



JJCW JOB CONTROL WORD TABLE 



I 



NAME SIZE (BYTES) 



NAME 



I TY | 



MODIFIER 



Name may be any alpha- 
numeric string, begin- 
ning with an alpha, 
between 1 and 255 char- 
acters long. 

TY 00 = OK 
01 = WARN 

10 = FATAL 

11 = SYSTEM 



MODIFIER = VALUE FROM TO %377777 
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AOPTIONS AMD FOPTIONS WORD BREAKDOWN 



OPTION WORD 2 
(AOPTIONS) 


OPTION WORD 1 
(FOPTIONS) 


0| 1 

1 o | 


0| 1 

1 o 1 


1 o | 

1 o 1 

31 jcopy 


1 o | 

2| I 

I | file type 
31 1 


U| | no -wait 


U| | 


51 1 

1 |multi- 
6 | | access 

71 | inhibit buff. 


51 | disallow files 

6| j labelled tape 

1 — | carriage 
7 1 1 control 


8| 1 

1 j exclusive 
91 1 

10 | | dynamic locking 

I — |wulti- 
11 | | record 


81 I 

i | record format 
91 1 

10 1 | 

i j default 
1 | designator 


12| | 

i | access type 


12| | 

131 jascii/binary 


151 | 


xU| ! 

I | domain 
151 1 
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PMASK WORD BREAKDOWN 





____ DMicrK" n/ron o 




| PMASK WORD 1 

! i 


FILE TYPE 


1 1 

| | BLOCK FACTOR 


LABELLED TAPE 


j JRECSIZE 


FRMS MESSAGE 


| (DISPOSITION 


USER LABELS 


S |NUMBUFFERS 


k 


| (INHIBIT BUFFERING 


5 


| | EXCLUSIVE 


POINTER ENTRY 


| |MULTI -RECORD 


DYN. LOCKING 


j | ACCESS TYPE 


WAIT.NOWAIT 


| |COPY,NOCOPY 


HULTI ACCESS 


| | CARRIAGE CONTROL 


NUMCOP 


| | RECORD FORMAT 


OUTPRI 


| | DEFAULT DESIGNATOR 


FILECODE 


! | ASCI I /BINARY 


FILESIZE 


| IDOMAIN 


NUMEXTS 


| | DEVICE 


INIT ALLOC 


1 jNAME 




15 


l->info 


present 


0->info 


absent 
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CHAPTER 9 RELOCATABLE OBJECT CODE 



USL FILES - GENERAL INFO 



* USL record length 128 words always. 

* Layout of doubleword disc addresses 



I I WORD # | 

I 25-BIT RECORD # | WITHIN RECORD | 

I " I 

2U 25 31 

* Hash links join all entries with the same hash key regardless of 
type. 

* Linear lists terminate with a zero link 

* Circular lists containing only the list head point directly to 
themselves . 

* Single-word disc addresses 

I - I 

I I WORD # | 

| 9 "BIT RECORD # | WITHIN RECORD | 

I I 

8 9 15 

Uninitialized fields are reserved for future use and should 
be set to zero. 
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* Hash code of an identifier is a numeric value which 
is calculated from a double word (containing information 
relative to the identifier) as follows: 

7 8 15 

I NC | CHAR 1 | 

HASH CODE := + + + MOD 95 

I CHAR | CHAR | 
I NC-1 J HC J 
+ + + 

where NC = number of characters in identifier 
CHAR 1 = Binary representation of first 

ASCII character 
CHAR NC-1 = Binary representation of next to last 

ASCII character (set to NC for single 

character identifier). 
CHAR NC = Binary representation of last ASCII 

character (=CHAR1 if single char 

identifier) . 

The hash code value is used as an index into the "Hash Bucket 
array" of record 0. 
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RECORD AND OVERALL USL FILE FORMAT 






LID 





1 

2 


NE 
DL 


1 
2 


3 


SUHDG 


3 


k 


NDG 


k 


5 


SABDL 


5 


6 


SAIPL 


6 


7 


SASL 


7 


10 
11 


FL 


8 
9 


12 


SAAD 


10 


13 


ADL 


11 


1»* 
15 


SAI 


12 
13 


16 
17 


IL 


ll» 
15 


20 
21 


SAAI 


16 
17 


22 
23 


AIL 


18 
19 


2U 
25 


TOTAL 
I.G. 


20 
21 


26 


NIG 


22 


27 
30 




23 
2U 



LOADER ID 

NR. DIRECTORY ENTRIES 

DIR. LENGTH 

TOTAL DIR, GARBAGE 

NR. DIR. GARB. ENTRIES 

S.A. BLOCK DATA LIST 

S.A. INTERRUPT PROC. LIST 

S.A. SEGMENT LIST 

FILE LENGTH 



NOTE: 
S.A. = Starting Address 



S.A. AVAIL. DIR. 
AVAIL. DIR. LENGTH 
S.A. INFO BLOCK 

INFO BLOCK LENGTH 

S.A. AVAIL. INFO 

AVAIL. INFO LENGTH 

TOTAL INFO GARBAGE 

NR. INFO GARB. ENTRIES 
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31 1 



32 1 

i 
331 

I 
3M 

I 
351 

I 
361 

I 
371 

I 
1+0 1 

I 

ltl| HL 
I C 

I 

I 
I 

I 

1771 HL 



25 
26 
27 
28 

29 
30 
31 
32 
33 HASH LINKS 



9k 



127 
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USL FILES - GENERAL INFO (CONT.) 



0-- 



I ! I 

| RECORD | | 

I I I 

I I I 

177 127 I 

I 

I 

200—-- 128 | 

I III 
| | DIRECTORY | 32K 
I | | MAX 
DL | ENTRIES | | 
I III 
I III 
I 

I I I 
| 

I SAAD | | | 

| | AVAILABLE | | 

ADL | DIRECTORY j j 

I III 



SAI* 

I I I 

| | INFO | 

IL | (HEADERS) | 

I I (CODE) | 

I I I 



I 
SAAI 

I I I 

AIL | AVAILABLE | 

| j INFO | 

I I I 
FL-1 

*SAI MUST BE ON A RECORD BOUNDRY 

NOTE: ALL ADDRESSES IN RECORD ARE WORD 
ADDRESSES. 
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USL FILES - GENERAL INFO (CONT. ) 



DIRECTORY ENTRY STRUCTURE 



SASL 




SEGL 
SEG.K 
SUBL 



<-- 




SEG.B 



SUBL | 

I 
PROC.C j 

I 



SUBL 



I 
I 
| PROC.A 

I 



I |SECL 



SUBL | 
MAIN 



CIRCULAR LINK POINTS TO ITSELF 
IF LIST IS EMPTY 




SECLI 



PROC.A 



A\ 

K >SEGMENT NAME ENTRIES 
B / 

A \ 

3 I 

A | 



PROC C \ 

PROC A >SUBPROGRAM 

MAIN / ENTRIES 



1 } SECONDRY ENTRY POINT ENTRIES 
i I 
5 / 
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General Entries 



+- 



+ + 

o — 



H 
A 

S— > 

H 



o- 
o- 



+ + 

— ->l I 
+ ! SEG 1 ! 

+ + 



+ + 

->| |<-+ 

— | MAIN I— + 

I I I 
+ + I 



+-■ +<-+ 

+->l I + 

| JPROC A| 

I I l< + 

I + +"+ 

-+ I 

I 

+ + I 

+--- >| |<-+ 

| PROC | 

I Al | 
-+ + + 



+ + I 

>l l<"+ 
+—IPROC B|— + 

I I.. I. 

+ + I 

I 
+ + I 

+ >l l<-+ 

IPROC C| + 

I I 

+ + 



+ + 

>l I 

+ 1 SEG 2 | 

I +->l I 
+ + 

I 



+ 



+ 



+ + 

I I 
>| HEADER | 

I I 
+ + 

+ + 

I I 
>| HEADER | 

I I 
+ + 

+ + 

I I 
>| HEADER | 

I I 

+ + 

+ + 

I I 
>| CODE | 

i i 

+ ♦ 
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BLOCK DATA 
+ + 

I o— I" 
+ + 



BLOCK DATA AND INTERRUPT PROCEDURE 



INDEX 
+ + 

o—l- 



H 
A 
S— > 

H 



-I 
I 
-I 
-I- 
-+ 



+• 

I 
I 
I 



+ 

I I 
-+ +- 



♦ + I 

>| BLOCK |< + 

I DATA J— + 
I A | 
+ + 



+ + 

•>| BLOCK |<-+ 

I DATA | + 

I B | 
+ + 



+ + 

•>| BLOCK |<- 
I DATA | 
I C | 

+ + 



•-+ 



INT. PROCS 
+ + 

I o—l- 
+ + 
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DATA DESCRIPTORS , PASSED PARAMETERS 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
— H-H-H-H-I-I--I--I--I--I--I — 

| MODE | STRUCTURE | TYPE 



TYPE WORDS CODE 



MULL 

LOGICAL 

INTEGER 

BYTE 

REAL 

DOUBLE 

LONG 

COMPLEX 

LABEL (SPL) 

CHARACTER 

LABEL (FORTRAN) 

UNIVERSAL (MATCHES ANY TYPE) 



STRUCTURE 

SIMPLE VARIABLE 

POINTER 1 

ARRAY 2 

PROCEDURE 3 

MODE 

NULL 

VALUE 1 

REFERENCE 2 

NAME 3 



NOTE: A descriptor of results in an automatic match. 








1 


1 


1 


2 


1/2 


3 


2 


U 


2 


5 


3 


6 


U 


7 




10 


N/2 


11 




12 




13 
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GARBAGE 

1 
I ///I NW 



DIRECTORY ENTRY TYPE 



10 11 15 

NW - Number of words in this 

I | block 




SEGMENT NAME 



DIRECTORY ENTRY TYPE 1 



1 7 8 


10 11 15 


I//I NW 


1 1 1 


1 HL | 


IA I///////I NC | 


CHAR1 | 


I (VARIABLE # CHAR. 

1 • 


SEE NC) j 


I CHAR. NC I////////////////I 


1 SEGL | 


1 L | SUBL 





NW - Number of words in entry 
block 

HL - Hash link - points to next 
entry having the same 
hash code 

A - Activity bit 

if active 

1 if inactive 
(initialize to 0) 

Note: An inactive segment 

implies that all entry 
points are inactive 

NC - Number of characters in 
name. Max is 15 

CHAR. 1 - First character in 
variable field 

CHAR. NC - Last character in 
variable field 

SEGL - Segment link - points to 
next segment name 
entry (0= End of list) 

SUBL - Subprogram link - points 
to next entry having 
the same segment name 

L - Last entry in list 

if not last 

1 if last 
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CLARIFICATION NOTES ON ENTRY TYPES 2 AND k 
WITH RESPECT TO SPL AND FORTRAN 



*ENTRY TYPE 2 
SPL O.B. 



**ENTRY TYPE k 
SPL PROC 



TPDB 



1,5 



*ENTRY TYPE 2 
FORTRAN MAIN 



1,2,3, J* 



**ENTRY TYPE U 
FORTRAN SUB. 



1,2, 3, J* 



TSDB 


TSDB 


TSDB 


TSDB 


NWPUST 


NWPUST 


NWPUST 


NWPUST 


5 
NWSDB 


NWO 


NWD 


NWD 



WHERE: TPDB = Total primary DB length in words 

TSDB = Total secondary DB length in words 
NWPUST = Number of words in "TRACE" array 
NWSDB = Number of words in secondary DB array 
NWO = Number of words in own array 
NWD = Number of words in data array 

Notes: 1. Does not include the length of the STLT 

2. Does not include the length of the FLUT 

3. Does not include the length of any common array 

k. Includes the length of any DB- allocated format array 
5. Are not necessarily equal 



In general TPDB and TSDB are summations of storage allocated in the 
global area of the program's data segment. They are not, however, 
complete since the compilers are not aware of all storage actually 
allocated! The STLT and FLUT are examples of this since these tables 
are constructed by the segmenter. Common arrays also present a problem 
since their inclusion in TPDB and TSDB might cause their storage 
requirements to be counted more than once. 

* See Entry Type 2 Format (Outer Block) 

** See Entry Type k Format (Procedure) . 
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DIRECTORY ENTRY TYPE 2 



OUTER BLOCK 

o 123U5678 10 11 15 



I//I 


NW | 2 | 


1 HI | 


1 A 


1 C | I |///| NC | CHAR 1 | 


I (VARIABLE # CHAR. SEE NC) | 

1 * 1 


1 CHARHC I///////////////////I 


1 L 


SUBL | 


1 L 


SECL | 


1 SSA | 


1 SAC | 
I RELATIVE TO SAI (SEE RECORD 0) | 


1 F | 


V I NWC | 


1 SE | 


1 TPDB | 


1 TSDB | 


1 NWPUST | 


1 NWD/NVSDB | 


1 T | 


NH | 


1 SAH | 
1 RELATIVE TO SAI (SEE RECORD 0) j 


I HDW | 
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DIRECTORY ENTRY TYPE 2 (CONT. ) 





• 






• 




I HDW | 




* 






• 




1 T | 


NH 




i SAH | 


I HDW | 




■ 






• 




1 


HDW 


1 



NW - Number of fiords in entry block. 

HL - Hash link - points to next entry with 
sane hash code. 

A - Activity bit. if active, 1 if inactive 
outer block. 

C - Callability bit set if entry point is 
uncallable . 

I - Priv mode bit - set if program unit is 
to be executed in priv mode. 

NC - Number of characters in name. Max is 15 . 

CHAR. 1 - First character in variable field. 

CHAR. NC - Last character in variable field. 

L - Last entry in list. 

if not last 

1 if last 
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DIRECTORY ENTRY TYPE 2 (CONT.) 

SUBL - Subprogram link - points to next entry 
having the same segment name. 

SECL - Secondary entry point list link. 

SSA - Program unit starting PB address. 

SAC - Starting FILE address of code 
module 

F - Set if fatal error 

W - Set if non- fatal error 

NWC - Number of words in code module. 

SE - Stack size estimate 

TPDB - Total number of words of primary 
DB to be allocated 

TSDB - Total number of words of secondary 
DB to be allocated. 

NWPUST - Number of words in trace array 
(PUST) 

NWD - Number of words in data array 
(FORTRAN) 

NWSDB - Number of words in secondary 
DB array (SPL) 

T - Terminating bit - set if last set of 
headers in entry 

NH - Number of headers 

SAH - Starting address of header (relative 
to SAI) 

HDW - Header DESCRIPTOR (Word 0) 
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DIRECTORY ENTRY TYPE 3 



OUTER BLOCK - SECONDARY ENTRY POINT 

o 123U5678 10 11 15 



I//I 


NW 1 3 1 


1 HL | 


1 A | 


C I//I//I NC | CHAR 1 | 


i (VARIABLE # CHAR. SEE NC) j 


1 CHAR NC | IIUIIIIIIIIUIIIIII \ 


1 L | 


SECL | 


I SSA | 



DIRECTORY ENTRY TYPE k 
PROCEDURE 
12 3 U567 8 10 11 



15 



I//I 


-I™ 


1 1 

NW | U | 


1 

|A | C| I| H| NC 


HL | 
| CHAR.l | 


1 
1 
1 


(VARIABLE # CHAR. SEE NC) | 


| CHAR.NC 




1 ////////////////////////////// 1 


IL | 




SUBL | 


IL | 




SECL | 


I SSA | 
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DIRECTORY ENTRY TYPE k (COST. ) 



SAC 



F | W| HWC 

SE 



TPDB 
TSDB 
NWPUST 
NWD/NWO 

HP I ////////////////////////////// 
TN 

PARM.l 



(VARIABLE # OF PARMS. SEE CN) 



PARM. HP 
T| NH 



SAH 



HDW 



HDW 



ETC 
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DIRECTORY ENTRY TYPE k (CONT. ) 



NW - Number of words in entry block 

MIi " Hasn link ■ points to next entry with same hash code 

A - Activity bit. if active, 1 if inactive entry point 

C - Callability bit set if entry point is uncallable 

I - Priv mode bit. Set if procedure is to be executed in priv mode. 

H - Hidden entry point. Set if entry point will not be in 

library directory. 
NC - Number of characters in name. Max is 15 . 
CHAR1 - First character in variable field. 
CHAR NC - Last character in variable field. 
L - Last entry in list 

if not last 

1 if last 

SUBL - Subprogram link. Points to next entry having the same segment 

Name 
SECL - Secondary entry point list link. 
SSA - Unit starting PB address 
SAC - Starting (file) address of code module 
F - Set if fatal error 
W - Set if non- fatal error 
NWC - Number of words in code module 
SE - Stack size estimate 

TPDB - Total number of words of primary DB to be allocated. 
TSDB - Total number of words of secondard DB to be allocated. 
NHPUST - Number of words in trace array (PUST) 
NWD - Number of words in data array (FORTRAN) 
NWO - Number of words in own array (SPL) 
P - Parm checker 

00 no checking. (Implies NP undefined, TN and PARH's absent) 

01 check procedure type. (Implies NP is undefined and PARM's 
absent) 

10 check procedure type and number of PARM's (implies PARM's 
absent) 

11 check procedure type, number of PARM 's and type of each PARM. 
NP - Number of PARM's 

TN - Procedure Type 

T - Terminating bit. Set if last set of headers in entry. 

NH - Number of headers 

SAH - Starting address of header 

HDW - Header Descriptor (Word 0) 
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DIRECTORY ENTRY TYPE 5 
PROCEDURE - SECONDARY ENTRY POINT 

0123U5678 10 11 15 



"1 

//I NW 


— -1 1 

1 5 


HL 


A| C |//|H | NC 


I CHAR. 1 


(VARIABLE #CHAR. 


SEE NC) 


CHAR. NC 


\m mini nun 


L | SECL 


SSA 



MW - Number of words in entry block 

EL - Hash link - points to next entry with 
saae hash code 

A - Activity bit. if active, 1 if inactive 
entry point 

C - Callability bit set if entry point is 
uncallable. 

H - Hidden entry point set if entry point 
will not be in library directory 

NC - number of characters in name , max 
is 15 

CHAR 1 - First character in variable field. 

CHAR NC - Last character in variable name. 

L - Last entry in list 

if not last 

1 if last 

SECL - Secondary entry point list link 
SSA - Unit starting PB" address 
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DIRECTORY ENTRY TYPE 6 
INTERRUPT PROCEDURE 



1 0|1 |2 


13 1 U567 ! 8 io|ll 15I 


I//I 


NW 


1 6 1 


1 HL | 


|A | IT 


I//I 


NC | CHAR.l | 


I (VARIABLE # CHAR. SEE NC) | 

1 * j 


| CHAR. 


NC 


I//////////////////I 


1 IPL | 


1 DBS | 


1 SSA | 


1 SAC | 


IF | W| 
IT | 




NWC | 
NH | 


1 SAH f 


1 HDW | 


i • i 


1 HDW | 
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DIRECTORY ENTRY TYPE 6 (COHT.) 

HW - Number of words in entry block 

HL - Hash link. Points to next entry 
with same hash code 

A - Activity bit. if active, 1 if 
inactive entry. 

IT - Interrupt procedure type number 

NC - Number of characters in name (maximum is 15) 

CHAR 1 - First character in variable 
field. 

CHAR NC Last Character in variable field 
IPL Interrupt procedure link 



DBS 



Number of words of DB storage 
required. 



SSA Itait starting PB' address 

SAC Starting (file) address of code 
module. 

F Set if fatal error 

W Set if non-fatal error 

NWC Number of words in code module 

T Terminating bit. Set if last set 
of headers in entry. 

NH Number of headers 

SAH Starting address of header. 

HDW Header Descriptor (Word 0) 
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DIRECTORY ENTRY TYPE 7 



BLOCK DATA 



1 o | 


1 1 2 | 3 1U567I8 

1 | i i 


10|11 15| 


I///I 


NW 


1 7 1 


1 HL | 


1 A | 


F | W |///| NC | 


CHAR.l | 


1 * 1 

j BLOCK DATA NAME | 

1 • 1 


! CHAR.NC I///////////////////////I 


| BDL | 


1 CAL | 


I///////////////I NC | 


CHAR.l | 


| t 1 

j COMMON ARRAY NAME j 

I • 1 


1 CHAR.NC I///////////////////////I 


1 T | 


NH 




I SAH | 


| HDW | 


1 • I 

1 • j 
| • 1 


! HDW ! 


11 • 1 

1 • 1 

1 • 1 
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DIRECTORY ENTRY TYPE 7 (CONT. ) 



CAL 
///////////////I NC | CHAR.l 



COMMON ARRAY NAME 



CHAR.NC | /////////////////////// 
T | NH 

SAH 



HDW 
ETC 



HW Number of words in block 

BL Hash link. Points to next entry with 
sane hash code. 

A Activity bit. if active, 1 if inactive 
block. 

F Set if fatal error. 

W Set if non-fatal error. 

NC Number of characters in name (max is 15). 

CHAR 1 First character in variable field. 

CHAR NC Last character in variable field. 

HDL Block data link 

CAL Common array length 

T Terminating bit. Set if last set of 
headers in entry. 

NH Number of headers. 
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SAH Starting address of headers. 
HDW Header Descriptor (Word 0) 
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DIRECTORY ENTRY TYPE 8 



PROCEDURE - SECONDARY ENTRY POINT 

01231*5678 10 11 15 

— I--I-I-I I I • 

///I NW I 8 



HL 
A I C|//| H| NC I CHAR. 1 



(VARIABLE fCHAR. SEE NC) 



CHAR. NC MIIIIUIIIIUIUIIUI 
L I SECL 



SSA 

I I I— I 

P I NP I///////////////////// 



TN 
PARM. 1 



PARM. NP 



NW - NUMBER OF WORDS IN ENTRY BLOCK 

HL - HASH LINK - POINTS TO NEXT ENTRY 
WITH SAME HASH CODE 

A - ACTIVITY BIT. IF ACTIVE, 1 IF INACTIVE 
ENTRY 

C - CALLABILITY BIT SET IF ENTRY POINT IS 
UNCALLABLE 

H - HIDDEN ENTRY POINT. SET IF ENTRY 
POINT WILL NOT BE IN LIBRARY 
DIRECTORY 

NC - NUMBER OF CHARACTERS IN NAME. MAX 
IS 15 
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DIRECTORY ENTRY TYPE 8 (CONT. ) 



CHAR 1 - FIRST CHARACTER IN VARIABLE LIST 

CHAR NC - LAST CHARTACTER IN VARIABLE 
LIST 

L - LAST ENTRY IN LIST 

IF NOT LAST 

1 IF LAST 

SECL - SECONDARY ENTRY POINT LIST LINK 
SSA - UNIT STARTING PB" ADDRESS 

P - PARM CHECKER 

00 NO CHECKING (IMPLIES NP UNDEFINED, 
TN AND PARMS ABSENT) 

01 CHECK PROCEDURE TYPE (IMPLIES NP 
IS UNDEFINED AND PARMS ABSENT) 

10 CHECK PROCEDURE TYPE AND NUMBER 
OF PARMS. (IMPLIES PARMS ABSENT) 

11 CHECK PROCEDURE TYPE, NUMBER OF 
PARMS AND TYPE OF PARM. 

NP - NUMBER OF PARMS 



TN - PROCEDURE TYPE 
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ENTRY HEADER FORMAT 



SAH 



SAH 



SAC 



HEADER 



HEADER 



HEADER 



CODE 



HEADER 



SAH 




EACH ENTRY (EXCEPT SECONDARY ENTRY POINT ENTRIES) 
MAY DESCRIBE N> SETS OF HEADERS. THE HEADERS IN 
EACH SET MUST BE CONTINUOUS AND IN THE SAME ORDER 
AS THE HOW LIST DESCRIBING THE SET. 

THE CODE MODULE MAY BE PLACED IN ANY POSITION IN A 
HEADER SET. NOTE THAT IF THE CODE MODULE IS AT THE 
BEGINNING OF A SET, SAC - SAH. 

IF THE ENTRY HAS NO HEADER SET, THEN NH, SAH SEQUENCE 
IS ABSENT. 
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HEADER TYPE 



GARBAGE 



10 11 15 




PCALs and LLBL HEADER TYPE 1 

0123U5678 10 11 15 



.|-|-|--| 



I 



//I 



NW 



PBA 



///////////I MC I CHAR. 1 



CHAR. HC I//////////////////// 
"p"""|"" HP I//////////////////// 



TN 
PARM. 1 



PARM. NP 



PBA - PB" ADDRESS OF LINKED LIST OF PCAL or LLBL 
INSTRUCTIONS TO BE REPAIRED - LOWER 
1U BITS USED AS NEGATIVE DISP. - BIT 
SET MEANS THAT WORD IS A LLBL 
INSTRUCTION WITH A POINTER TO A SST 
LABEL OF ' 'EXTERNAL' ' FORMAT - A 
LINK OF TERMINATES THE LIST - BIT 1 
SET MEANS THAT THE WORD IS TO BE 
INITIALIZED WITH THE PB ADDRESS OF 
THE PROCEDURE. 
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HEADER TYPE 2 
PB ADDRESSES 

1 10 11 15 

"I I- 

//I NW | 2 

PBA 



PBA 



PBA - PB' ADDRESS OF PB ADDRESS 
TO BE CORRECTED 



OWN/DATA VARIABLES 



1 
-I — 
//I 



B| 



B| 



MW 



HEADER TYPE 3 



10 11 15 
— I 

I 3 



PBA 



PBA 



PBA - PB' WORD ADDRESS OF OWN VARIABLE 
POINTER TO BE CORRECTED 

B - is set =1 to mean that (PBA) is a 
BYTE OFFSET. 

(PBA) - Secondary DB-relative OFFSET. 
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HEADER TYPE U 
SDB/OWH/DATA/VALUES 

1 10 11 15 



I///I 


NW | 


U 1 


| LD 


1 B | 


IN 




| INITIAL VALUES j 



LD - LOGICAL WORD DISPLACEMENT 

IN OWN ARRAY FOR INITIAL VALUES 

B - BYTE BIT-SET IMPLIES THAT LD IS A 
BYTE OFFSET AND THAT THE FIRST 
WORD OF THE INITIAL VALUE BLOCK 
IS A COUNT OF THE NUMBER OF BYTES 
IN THE INITIAL VALUE BLOCK 

IN - INTERATION NUMBER - NUMBER OF 

TIMES THE BLOCK OF INITIAL VALUE 
IS TO APPEAR IN THE SECONDARY DB - 
1->N0 DUPLICATION, 
2- >DUPLI CATION, ETC 

HEADER TYPE 5 



PUST 



1 


10 11 15 


I//I 


NW 15 1 


j PBA 


| INITIAL VALUES 1 



PBA - PB' ADDRESS OF LINKED LIST OF 

POINTERS TO BE INITIALIZED WITH 
DB ADDRESS OF PUST (SAME LIST 
FORMAT AS FOR FORMAT STRINGS) 
A PBA of -1 INDICATES NO FIX-UPS. 

NOTE: ALL REFERENCES TO THE PUST INCLUDE THE FOUR-WORD HEADER 
THAT IS APPENDED BY THE SEGMENTER. THESE WORDS ARE NOT 
PRESENT IN THE HEADER; THEY ARE AUTOMATICALLY 
ALLOCATED AND INITIALIZED BY THE SEGMENTER. 



9-29 



HEADER TYPE 6 
GLOBAL VARIABLES 

1 7 8 10 11 15 



l"l— - 

I//I NW 


-1 1" 1 

1 6 | 


1 TN ! 


I DBA 


I/////////I NC | 


I CHAR.l 


I CHAR. 2 | 


! * ^ 


I CHAR. NC 


I///////////////I 



HEADER TYPE 7 



EXTERNAL VARIABLES 



01231*5678 
I--H-H-H-I-I — 

I//I NW 


10 
— — 1 

1 


11 15 
7 1 


1 TN | 


1 M|/////| 


NC | 


CHAR. 


1 i 


1 • ! 


1 CHAR. 


NC I////////////////I 


1 DA | 


1 PBA j 


1 * E 

1 » ! 


I PBA | 



PBA-PB" address of linked list 
of instructions to be repair- 
ed; lower 8 bits of inst. used 
as neg. displacement to next 
instruction; a link of 
terminates the list. 

M -Monitored variable bit; set 
if variable is being mon- 
itored by debug. 

DA -Logical word disp. in FUST; 
lower 8 bits of word will be 
init. with prim.DB address 
of variable ;DA is present 
only if M=l. 

NOTE: PBA of -1 implies null list 
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HEADER TYPE 8 



PRIMARY DB 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
-H-H-H-H-H--I-I--I--I--I" 

l\ NW I 8 



U|U |U |U | U |U |U |U 
0| 1| 2 I 31 U | 51 6| 7 



u |u |u |u |u Mil I III II III 

N-51 M-UI M-31 N-2| N-l 1 1 1 II II III III 



INITIAL VALUES 



U - ADDRESS BITS 

00 IF NO ADDRESS 

01 IF NO ADDRESS 

10 IF WORD ADDRESS IN SECONDARY DB 

11 IF BYTE ADDRESS IN SECONDARY DB 

N - NWPDB 

NOTE: INITIAL ADDRESSES THAT ARE 

SECONDARY DB ADDRESSES ARE 
RELATIVE (I.E., THEY ARE 
LOGICAL DISPLACEMENTS IN 
SECONDARY DB). 
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HEADER TYPE 9 



COMMON VARIABLES 

0123»*5678 10 11 15 

■H-H-l-H-l 



//I 



NV 



I 

I 9 



NWC 



////////I HC | CHAR. 1 



CHAR. NC | /////// II I II I HI 



B| M| 



B| M| 



NL 
LD 
DA 
PBA 



PBA 



NL 
LD 
DA 
PBA 



PBA 



I 

i 

NL 

I 



I 
I 
NL 

I 
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HEADER TYPE 9 (CONT.) 



NWC - NUMBER OF WORDS IN COMMON ARRAY 

NC - NUMBER OF CHARACTERS IN COMMON 
NAME- IF BLANK COMMON k COM' 

DA - LOGICAL WORD DISP. IN PUST - LOWER 

8 BITS OF WORD WILL BE INIT. WITH 

PRIM. DB ADDRESS OF VARIABLE - NOTE 
DA IS PRESENT only if M = 1 

B - BYTE BIT 

IF THE PRIMARY DB POINTER TO BE 
ALLOCATED AND INITIALIZED AND LD 
ARE OF TYPE WORD 

1 IF TYPE BYTE 

M - MONITORED VARIABLE BIT - SET IF 
VARIABLE IS BEING MONITORED BY 
DEBUG 

NL - NUMBER OF ADDRESS LISTS FOR 
VARIABLE 

LD - LOGICAL DISPLACEMENT OF VARIABLE 
IN COMMON ARRAY 

PBA - PB" ADDRESS OF LINKED LISTS OF 
INSTRUCTIONS TO BE REPAIRED 
LOWER 8 BITS USED AS NEGATIVE 
DISPLACEMENT TO NEXT INSTRUCTION 
A LINK OF TERMINATES THE 
LIST 

PBA = -1 INDICATES NO FIX-UPS 
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HEADER TYPE 10 



LOGICAL UNITS 


l"l I 



I//I 



10 11 15 
10 



BIT MAP 
(7 Words) 



BIT MAP - BIT M AP OF LOGICAL UNITS 
REFERENCED; BIT 
CORRESPONDS TO LU 0, ETC. 
(1 LESS THAN OR EQUAL TO LU 
LESS THAN OR EQUAL TO 99) 
1 <= LU <= 99 



HEADER TYPE 11 



FOUrysX STRING 








10 11 15 


I//I 


NW 


1 11 1 


! PBA | 


1 NC j 


! CHAR. 1 


1 


CHAR. 2 | 


4 


4 




I CHAR. NC 


I////////////////I 



PBA - PB' ADDRESS OF LINKED LIST OF 
POINTERS TO BE INITIALIZED- - 
LOWER lh BITS OF WORD USED 
AS NEGATIVE DISPLACEMENT TO 
NEXT POINTER - BIT SET 
MEANS THAT THE POINTER IS TO 
BE TYPE BYTE - A LINK OF 
TERMINATES THE LIST. 



9-31* 



RL FILE FORMAT 



0| LID | 
1| FL | 


2| NS | 


31 ! 


M 1 

I SAXL | 
51 1 


61 I 
71 1 

io| 1 
111 i 

121 ! 


Ul| HL | 
1 o | 


1 • 1 


1771 HL | 
1 9»» 1 





1 

2 
3 

k 

5 
6 
7 
8 

9 
10 



LOADER ID 

FILE LENGTH (IN RECORDS) 

NR. SECTIONS 




S.A. EXTERNAL SET LIST 



1| 

I 



| FREE HAP 
I 
I 



NS | 

I 



I FREE HAP 
I NS-1 



NOTE: UNINITIALIZED FIELDS ARE 

RESERVED FOR FUTURE USE AND 
SHOULD BE ZERO. 



NS+1 



33 S.A. HASH LIST 



127 S.A. HASH LIST 9^ 
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STORAGE MANAGEMENT 



FILE SPACE IS MANAGED IN TERMS OF 32 WORD BLOCKS (1* BLOCKS PER 
128 WORD RECORD) . 



FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN A BIT MAP, WHICH IS 
PARTITIONED INTO RECORDS (2K BLOCKS PER SECTION). A INDICATES 
THAT A BLOCK IS USED, A 1 INDICATES THAT IT IS FREE. 

FILE SPACE IS ALSO PARTITIONED INTO 512 RECORD SECTIONS (6U MAX. 
SECTIONS, 2K BLOCKS PER SECTION, 1 MAP PER SECTION). THE NUMBER 
OF SECTIONS IN A FILE IS NS=(FL+511) & LSR(9). THE FIRST NS 
RECORDS FOLLOWING RECORD (RECORDS 1 TO NS) ARE RESERVED FOR THE 
SECTION MAPS. 



A COMPLETE FILE ADDRESS WOULD HAVE THE FOLLOWING CONFIGURATION: 



1 2 3 U 5 6 15 16 26 27 31 

! i i i I 

I | SECTION | BLOCK | DISPLCMT | 



FILE (WORD) ADDRESS 
DOUBLE WORD 
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ENTRY POINT DIRECTORY 



I HL | 



LINK 
USED 



//////// 
//////// 



LINE 



USED 



■>. . .--> 



I //////// I 



USED 



//////// 
//////// 



THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SAME HASH 
FUNCTION AS USL); EACH HASH LIST IS A LINKED LIST OF RECORDS. 

EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD #) AND A USED SPACE 
COUNT. A LINK OF TERMINATES A LIST. WHEN A RECORD IS VOID OF 
ENTRIES (USED=2) , ITS SPACE IS RETURNED TO THE FREE STORAGE AREA. 
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TYPICAL DIRECTORY ENTRY 



12 3 U567 8 



15 



1— 1— 1— 

1 s I u I I 


1 — 1 1 1 

|///| NC | CHAR. 1 | 




1 CHAR. 


NC I//////////////////////I 


1 S.A. INFO BLOCK | 


j S.A. ENTRY I 


1 F | W | 


NW CODE 


1 LC | 


NP | CN | 


I TN I 


| PARH. 1. I 


1*1 
I * i 

if • 1 


| PARM. NP I 



S - SECONDARY ENTRY POINT BIT - SET IF 
THE ENTRY POINT WAS ORIGINALLY A 
SECONDARY ENTRY POINT. 

U - UNCALLABLE BIT - SET IF ENTRY POINT 
IS UNCALLABLE. 

I - PRIVILEGED MODE BIT - SET IF CODE 
MODULE IS TO BE RUN IN PRIV. MODE. 

LC is (0:2).. .Level of Checking 

= No checking 

1 >= Check for procedure type 

2 >= Check for # parameters 

3 >= Check for parameter type 
NP is (2:6) is # parameters 
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PROCEDURE INFO BLOCK 



15 



j NW INFO | 


| NW CODE | 1 


j # ENTRY POINTS | 1 


1 III 
CODE MODULE | NWC | 

| 111 


1 EXTN LINK | 


j TPDB 1 1 


| TSDB ! 1 


| NWSDB 1 NWI 


I HEADER | ! 


j HEADER | I 


I • II 


j HEADER ! | 

i j j 


1 -i 1 



ALL HEADERS FOR THE PROCEDURE ARE APPENDED TO THE INFO BLOCK. THE 
HEADER SETS (EXTERNAL LISTS) ARE LINKED BY INCREASING FILE 
ADDRESS; A LINK OF J17777777777D TERMINATES THE LIST. 
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HEADERS 



12 3 ^567 8 

— I — I — I — I I" 

///l MW 



10 11 15 

— I 

I 1 



F I W 



NW CODE 



S.A. INFO BLOCK 



S.A. ENTRY 
PBA 
S I U I I |///| NC I 



CHAR. 1 





CHAR. NC 


1 /////////////////////// 


p 


| HP 


| CN 


TN 


PARM. 1 



PARM. NP 



F - SET IF FATAL ERROR 

W - SET IF NON-FATAL ERROR 

S - SATISFIED BIT - SET IF EXTERNAL IS 

SATISFIED WITHIN RL. 
U - UNCALLABLE BIT 
I - PRIVILEGED BIT 



ALL HEADERS ARE THE SAME AS IN A USL EXCEPT FOR THE PCAL HEADER. 
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CHAPTER 10 PREPARED OBJECT CODE 



o| 


FLAGS | 





ll 


NS | 


1 


2| 


GS 1 


2 


31 


SAG 


3 


M 


SAS i 




51 


iss ! 


5 


61 


IDLS ! 


6 


71 


MAXD ! 


7 


10 1 


SAE 


8 


111 


SSEG 


9 


12 1 


SADR 


10 


131 


SASTLT 


11 


i*»! 


SAFLUT 


12 


15 


SAX 


13 


16 


SSTT 


nu 


17 


SATC 


H5 


20 




U6 


21 




117 


22 




U9 


23 




U9 


2U 




|20 


25 




|21 


26 




|22 



PROGRAM FILE FORMAT 

NUMBER OF CODE SEGMENTS 

GLOBAL SIZE (DB TO QI) IN WORDS 

GLOBAL AREA RECORD # 

SEGMENT SET RECORD # (EACH SEG. STARTS IN NEW 

RECORD) 

INITIAL STACK SIZE IN WORDS 

INITIAL DL SIZE IN WORDS 

MAX. DATA SEGMENT SIZE (DL TO Z) IN WORDS 

ENTRY POINT LIST RECORD # 

STARTING SEGMENT # 

PRIN. ENTRY PT PB ADDRESS 

DB ADR. OF STLT (-1 IF NO STLT) 

(STLT=Segment Length Table) 
DB ADR. OF FLUT (-1 IF NO FLUT) 

EXTERNAL LIST RECORD # 

PRIN. ENTRY PT SST # 

STARTING ADDRESS OF TRAPCOM" 

NOTE: UNINITIALIZED FIELDS ARE 

RESERVED FOR FUTURE USE AND 
SHOULD BE ZERO. 



PROGRAM FILE FORMAT (CONT.) 
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27 
30 
31 
32 
33 

3U 



CST | CST 
o I 1 



CST |////// 
n I////// 



P|S| SL 



P|S| SL 



23 
2k 

25 
26 

27 
28 \ 



> CST REMAPPIMG ARRAY 



> SEGMENT DESCRIPTOR ARRAY 



P-PRIVILEGED MODE 

S-Segment STT format: 0=> old format, 1=> new (extended) format 

H=NS -1 

K=28 + (NS +1) & LSR (1) 

L={(28 + NS + (NS + 1)&LSR(1) + 127)/128)128 - 1 
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FLAGS 

1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 
|.|_.|..|._|..|..|..|..|..|..| — | — I — I — 1-_| — | 

|F|W |Z |P |//|//| |BA|IA|PM| | | MR|///| DS| PH 

F - FATAL ERROR IN PROGRAM 
W - NON-FATAL ERROR IN PROGRAM 
Z - ZERO UNIT DL AREA 

P - SET IF ANY SEG IS PRIV. (IF NOT SET NORMAL* 
NONPRIV MODE) 



CAPABILITIES 

/ BATCH ACCESS (9) [BA] 

INTERACTIVE ACCESS (8) [IA] 

PRIVILEGED MODE (7) [PM] 



ACCESS TO 

GENERAL 

RESOURCES 



MULTIPLE RINS (U) [MR] 

EXTRA DATA SEGMENT (2) [DS] 
PROCESS HANDLING (1) [PH] 
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CST REMAPPING ARRAY 



CONTAINS THE LAST CST NUMBERS ASSIGNED TO THE SEGMENTS; 
INDEXED BY SEGMENT NUMBER. WHEN A PROGRAM FILE IS 
PREPARED, THE ARRAY IS INITIALIZED TO 0, l...,N. 
THIS ARRAY IS USED TO RE-ESTABLISH INTRA-PROGRAM 
LINKAGE WHEN THE PROGRAM IS LOADED. 

SEGMENT DESCRIPTOR ARRAY 



CONTAINS THE SEGMENT LENGTH AND A FLAG INDICATING IF THE 
SEGMENT IS TO BE LOADED IN PRIV. MODE. INDEXED BY 
SEGMENT NUMBER. ALL SEGMENTS BEGIN ON A RECORD BOUNDARY. 
THE NUMBER OF RECORDS FOR A GIVEN SEGMENT IS (SL + 127) 
& LSR(7). THE RECORD NUMBER, SAS, OF SEGMENT N IS 

SAS:=0 

FOR 1=0 TO N-l 

BEGIN 

SAS:=SAS + (SL(I) + 127)&LSR(7) 

END 



GLOBAL AREA FORMAT 



A SET OF RECORDS CONTAINING THE INITIAL VALUES FOR THE 
GLOBAL AREA OF THE DATA SEGMENT. THIS SET BEGINS AT 
RECORD SAG (WORD 3) AND CONSISTS OF (GS + 127) i LSR(7) 
RECORDS. 
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EXTERNAL LIST 



7 8 15 



1 — 1 — 1 1 

I///JNC | CHAR 1 | 


! ' ' 


ICHAR NC| ////////| 


t NR | 


I STT # | SEG # j 


1 • 1 
• 1 

1 * I 


j STT # | SEG # | 

1 _i i 


II 1 

|LC| HP | CN j 
i_i _i 


1 | „| 

! TN | 


1 PARM 1 1 


1 * 1 




I PARM NP | 


• 


1 o | 



TYPICAL ENTRY 



I 
/ 



NP 



CHECK 



CHECK 



1&2 



CHECK 3 



LIST TERMINATER 



LC (0:2) = LEVEL OF CHECKING 

= NO CHECKING 

1 >= CHECK FOR PROCEDURE TYPE 

2 >= CHECK FOR # PARAMETERS 

3 >= CHECK FOR PARAMETER TYPE 
NP (2:6) IS # PARAMETERS 
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ENTRY POINT LIST 



I////I 


NC 


I CHAR 1 | 


1*1 


I CHAR 


NC 


I/////////I 


1 


P.B. 


ADR 


1 STT # j 


• 
• 


I////I 


NC 


| CHAR 1 | 


1 • 1 


| CHAR NC 


I/////////I 


1 


P.B. 


ADR g 


1 STT # 


1 o | 



LIST TERMINATOR 



NOTE THAT THE ENTRY POINT LIST MUST IMMEDIATELY 
FOLLOW THE EXTERNAL LIST. 
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SL FILE FORMAT 



RECORD 




1 
2 
3 
U 

5 
6 
7 

10 
11 
12 
13 
1U 



Ul 



177 



LID 
FL 
EL 



NSEG 



FRTL 



NRT 



NS 



HLO 



HL9U 



1 FILE LENGTH (IN RECORDS) 

2 EXTENT LENGTH (IN RECORDS) 

3 

k # SEGMENTS 

5 

6 

7 S.A. OF FREE R.T. ENTRY LIST (-1 IF NONE) 

8 

9 # REFERENCE TABLE ENTRIES 

10 

11 # SECTIONS 

12 



33 



NOTE: 

SHADED AND UNITIALIZED FIELDS ARE 
127 RESERVED FOR FUTURE USE AND 

SHOULD BE ZERO. HL = HASH LIST. 
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SL FILE FORMAT (CONT. ) 



I RECORD | 
I | 
I I 



RECORD 

1 



REFERENCE TABLE POINTERS 
For entire SL file. 



I I 

I FREE HAP | 

I | 

I I 



There is one free map 
record for each section. 



NS+1- 



I I 

I FREE HAP | 

I NS-1 | 

I I 



NS+2 
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STORAGE MANAGEMENT 



FILE SPACE IS MANAGED IN TERMS OF 128 WORD BLOCKS (1 BLOCK PER 
128 WORD RECORD). 

FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN A BIT MAP, WHICH IS 
PARTITIONED INTO RECORDS (2K BLOCKS PER SECTION). A INDICATES 
THAT A BLOCK IS USED; A 1 INDICATES THAT IT IS FREE. 

FILE SPACE IS ALSO PARTITIONED INTO 20U8 RECORD SECTIONS (16 
MAX. SECTIONS, 2K BLOCKS PER SECTION, 1 MAP PER SECTION). THE 
NUMBER OF SECTIONS IN A FILE IS NS=(FL + 20U7) & LSR(ll) . THE 
FIRST NS RECORDS FOLLOWING RECORDS 0, 1 (RECORDS 2 TO NS+1) 
ARE RESERVED FOR THE SECTION FREE MAPS. 

IF THE SECTION MAPS SPECIFY MORE SPACE THAN IS POTENTIALLY 
AVAILABLE, THOSE RECORDS BEYOND FLIMIT ARE MARKED AS "USED". 



ENTRY POINT DIRECTORY 



I HL | 



LINK 



USED 



///////// 
///////// 



LINK 



USED 



///////// 
///////// 



-> > 



USED 



///////// 
///////// 



THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SAME HASH 
FUNCTION AS USL); EACH HASH LIST IS A LINKED LIST OF RECORDS. 

EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD #) AND A USED SPACE 
COUNT. A LINK OF TERMINATES A LIST. WHEN A RECORD IS VOID OF 
ENTRIES (USED=2) , ITS SPACE IS RETURNED TO THE FREE STORAGE 
AREA. 

THE HASH LIST HEAD POINTERS (HL IN THE DIAGRAM ABOVE) ARE IN RECORD 
WORDS %kl TO %177. 
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TYPICAL DIRECTORY ENTRY 



1 2 3 ** 


5 


6 


7 8 9 10 11 12 13 lU 15 


I///I u I///I P | 


MC 




i CHAR 1 | 


1*1 

1 ♦ 1 


I CHAR NC 






1 IIIIIIIIIIIIIIIIIIUIIIIIIUIU 1 


j STT.f 






1 SEG # | 


LC | HP 






1 IlllllllUllllilliillllllllllll 1 


I TN | 


1 PARM 1 ] 


1 ■ • I 


1 PARM HP j 



LC is (0:2)... Level of Checking 

■ Ho checking 

1 >= Check for procedure type 

2 >= Check for # parameters 

3 >s Check for parameter type 
HP is (2:6) is # parameters 

P - 0= Hot permanently allocated 
1= Permanently allocated 

U - Uhcallable bit - set if entry 
point is uncallable. 
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CODE SEGMENT LINKAGE STRUCTURE 



I I 

CODE SEGMENT 



STT MAP ARRAY 



EXTERNAL LIST 



EACH CODE SEGMENT OCCUPIES AN INTEGRAL NUMBER OF RECORDS. THIS BLOCK 
OF INFORMATION CAN BE SUB-DIVIDED INTO THREE TABLES: THE CODE SEGMENT 
PROPER, AN STT SEGMENT MAP ARRAY, AND AN EXTERNAL LIST. 



STT MAP ARRAY 

A 1 BYTE X 256 BYTE ARRAY. IT IS INDEXED BY STT NUMBER AND RETURNS 
(IF THE STT CORRESPONDS TO AN EXTERNAL OF THE SEGMENT) THE SEGMENT 
NUMBER OF THE EXTERNAL AND 255 OTHERWISE. THIS ARRAY IS USED WHENEVER 
THE SEGMENT IS LOADED AND IS UPDATED WHENEVER THE SL IS BOUND BY THE 
SEGMENTER. 



EXTERNAL LIST 

A SYMBOLIC LIST OF THE EXTERNALS OF THE SEGMENT. EACH ENTRY CONTAINS 
INFORMATION ABOUT THE EXTERNAL: PARAMETER CHECKING LEVEL AND PARAMETER 
MATCHING INFORMATION, AND THE SEGMENT NUMBER AND STT NUMBER IF THE 
EXTERNAL IS SATISFIED WITHIN THE SL. 
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CODE SEGMENT STRUCTURE (CONT.) 



12 3 U567 8 15 
-l-l.-l-l— -I 



CODE SEGMENT 



STT MAP ARRAY 



Sl/I/I/I NC I CHAR. 1 



CHAR. NC I//////////// 
STT f I SEG. # 



P I HP \U U I HI I II I 

TN 
PARM. 1 



PARM. NP 



S - SATISFIED BIT - SET IF EXTERNAL 
IS SATISFIED WITHIN SL 



EXTERNAL LIST TERMINATOR 
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REFERENCE TABLE STRUCTURE 



FOR EACH SEGMENT THERE IS A REFERENCE TABLE ENTRY OF 32 WORDS. THE 
REFERENCE TABLE ENTRIES ARE PACKED FOUR TO A RECORD. THE RECORDS 
CONTAINING THE REFERENCE TABLE ENTRIES ARE LISTED IN RECORD 1. THE 
RECORD CONTAINING REFERENCE TABLE ENTRY N IS REC 1 (N. (0 : lU)); THE 
FIRST WORD OF THE ENTRY IS REFTAB (N.(lU : 2) & LSL (5)). 

WHEN A SEGMENT IS DELETED, THE REFERENCE TABLE ENTRY CORRESPONDING TO 
THE SEGMENT IS RELEASED. THESE FREE ENTRIES ARE LINKED TOGETHER IN A 
LIST; THE SEGMENT f IS USED AS A LINK AND IS PLACED IN THE FIRST WORD 
OF THE ENTRY; -1 TERMINATES THIS LIST — THE LIST HEAD IS 
RECORD (7), FRTL. 

WHEN A SEGMENT IS ADDED IT IS ASSIGNED A SEGMENT NUMBER (0 LESS 
THAN/EQUAL TO N LESS THAN/EQUAL TO 25U); THE NUMBER IS THAT OF THE 
FIRST FREE REFERENCE TABLE ENTRY, OR, IF NONE ARE FREE, THE NEXT 
AVAILABLE REFERENCE TABLE ENTRY (CAUSING SPACE ALLOCATION FOR THE 
ENTRY). 
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REC. 1 


R.T 


. REC. 


I RL 

1 o 


--> J 


E | 

o I 


I 


1 E | 

i i i 


1 * 


1 E | 
1 2 | 


I RL 
1 63 


1 E ! 
1 3 1 



REFERENCE TABLE (256 MAX. ENTRIES 
TYPICAL ENTRY 

15 



) 



(FILE REC1) (1 SECTOR) 

SEG.NAHE -16 BYTE ARRAY 
WITH NO CHARAC- 
TER COUNT AND 
TRAILING BLANKS 
ADDED. 

REF.MAP -256 BIT ARRAY 

(INDEXED BY SEG#); 
BIT SET IF SEG IS 
REFERENCED DIRECT- 
LY OR INDIRECTLY. 

F SEGMENT DELETED 

S EXTERNALS SATISFIED 

A PERMANENTLY ALLOCATED 

C CORE RESIDENT SEGMENT 

X MPE SEGMENT 

P PRIV.INST. IN SEGMENT 



SLSEGFLAGS: 

0:1 ■ => SEG STT IS IN 

OLD FORMAT 

= 1 => SEG STT IS IN 

NEW FORMAT -- 

EXTENDED CSTS 



FLA3S: 



OI23U56789 

-H-l-l-l-H-l-l 

P|/| SEGMENT LENGTH 



SEGMENT ADDRESS (REC. #) 
# REC'S FOR SEG. & EXTN. LIST 
F|S|/|/|A|C|X|/|/| # ENTRY PTS. 
SLSEGFLAGS 



(0:1) Segment STT format 
U:15) Reseived 



SEGMENT NAME 



REFERENCED SEGMENTS 
BIT MAP 



% 

1 
2 
3 
h 

5 

6 

7 
10 



20 
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CHAPTER 11 LOADER 



MPE LOADER 



The first area of the CST, pointed to by absolute 0, contains system 
and library segments. Its size is configurable but it may not contain 
more than 191 entries. This area is assigned CST numbers l-%277. The 
second area is used for programs. The total number of entries in this 
area is not hardware limited. This area is allocated a block at a 
time with one program per block. A block may contain from 1 to 63 
segments, which will be assigned CST entry numbers %301-%377. The 
maximum number of segments in a program file is 63 and segments of 
different programs will have the same CST number. Thus both a block 
number and a CST# are required to uniquely identify a program segment. 
A fallout of this is that logical segment=physical CST-%301. ( 

The loader is a system process which will do loads sequentially. 
If a process needs code to be loaded, it will get the load process' 
SIR, fill a communication data segment and then awake the loader. 
Upon completion, the loader will return its status through the 
communication data segment and then activate the waiting process. 
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LOADER SEGMENT ALLOCATION 



The order in which storage is allocated for arrays is arbitrary, with 
one exception: The storage for array DIR must be last in the data 
segment. This allows the data segment expansion/contraction intrinsics 
to be applied so that DIR storage may be dynamically allocated. 



(DB+3) 

(DB+14)' 
(DB+5)- 



(DB+e)- 



DATA LABELS 



REF TAB 
(ref count) 



XFORM 
ENT TAB 



SBUF 
SBUF 1 



SBUF 2 
SBUF 3 
SBUF a 



DIR 



PRIMARY DB 
REFERENCE COUNT TABLE 

SEGMENT TRANSFORM TABLE 
ENTRY INDEX TABLE 



\ 



> UTILITY BUFFERS 
I (128 words each) 



DIRECTORY 



11-2 



OJ UTILITY INTEGER 


1| DIRECTORY LENGTH 


2| ENTRY TABLE POINTER 


3| REFERENCE COUNT TABLE 
j POINTER 


H| CST TO LCST AND FLAG 
| TABLE POINTER 


51 CST TO ENTRY INDEX 
l TABLE POINTER 


6\ SECONDARY ENTTAB 
I POINTER 


7| ENTRY POINTER 


10 j SECONDARY ENTRY 
| POINTER 


111 SECOND RECORD DISC 
j BUFFER POINTER 


12| 


131 


1U| 


151 


l6| UTILITY INTEGER 


171 


20 1 


21 1 


22| 


231 


2U| 


251 


26| 



LOADER SEGMENT TABLE PRIMARY DB (DST %22) 
SO 

DIRLEN 
DIR 
REFCOUNT 

XFORM 

ENTTAB 

ZNTP2 

ENTP 
3NTP1 

SBUFO 

SBUF1 

SBUF2 

SBUF3 

SBUFU 

SI 

SJ 

SE 

SL 

SM 

SN 

SP 

I 

SQ 271 

I - 

SR 30| 

I 



I 

|ss 

I 

1ST 
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REFERENCE COUNT TABLE 
<DB + 3) 



Indexed by CST number; contains the 
reference count for each code seg- 
ment. Contains -1 if the CST 
entry is not allocated. 



SEGMENT TRANSFORM TABLE 
(DB + k) 



RIGHT 
BYTE 




Indexed by CST number; contains the 
file-relative (logical) segment 
number and segment attributes. 



I 0| 1| 2| 31 k\ 51 6| 71 8| 9U0|ll|12|13|lU|15l 

T I A| C| X|////////| 



I — I — I — J — I — I — I — I — I- 



SEG# 



T-Segment Type: 



I-- 

System SL =0 
Public SL =1 
Group SL -2 
Program Seg =3 



l-l-l-l 



I 



A-Perm. Allocated Segment (1/0) 
C-Core Resident Segment (1/0) 
X-System (MPE) Segment (1/0) 
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ENTRY INDEX TABLE 
(DB + 5) 




Indexed by CST number; contains the 
directory index of the file entry 
corresponding to the CST number. 



DIRECTORY 
(DB + 2) 




Accessed by entry key - contains vari- 
able length entries, each entry describ- 
ing a set of CST numbers. 



The directory is completely filled with variable length entries. The 
empty state is represented by a single garbage entry. It is accessed 
by a sequential search using a double word entry key, or by direct 
indexing using ENTTAB. 

The first word of each entry has the same format and includes an entry 
type number. In addition, most entries (all entries except type 
garbage) have an implicit double word entry key. Those entries that 
have an explicit single word key have an additional word that is 
implicitly 0. The entry key immediately follows the entry descriptor 
(first) word. 

For file entries, the key is the double word sector number of the file 
label with the first byte of the double word replaced with the logical 
device number. For process entries, the key is the single word PIN 
with the first byte of the single word replaced with the extension 
number (LOADPROC id number). 
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ID1 



ENTRY POINTER (ENTP) 



(DB + 7) 





1 0| 1| 


21 31 *»l 5| 6| 71 8| 9UO|ll|12|13|lU|l5 









1 A| LS | F| P| | 


ET 




1 


#wds in garbage entry/process id 


ENWG,EPID*,EF 


2 


Second word of file ID 


EF102 


3 


Working set pointer 


EWSP 


k 


CST block index 


ECST 


5 


Prog file reference count 


ESHR 


6 


ISegaents in file 


ESEG 



A * Program Allocated 

F ■ File Mode 
P " Program Mode 
ET » Entry Type 

•BPID 



I 0| 1| 2| 3! k\ 51 6| 71 8| 9llO|U|12|13|ll»|l5l 



EXTENSION NUMBER | 



PIN NUMBER 



EFID1 = First word of file ID 
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SBUFO (DB + 9) 





01 


11 


21 31 U| 51 6| 71 8| 9ll0|ll|12|13|lU|l5 





F| 


HI 


ZI////////I CAP LIST 


1 


Number segments 


2 


Global area size 


3 


REC. NR. of global area 


U 


Rec. nr. of segment list 


5 


Stack size 


6 


DL size 


7 


Max. data seg. size 


10 


Rec. nr. of entry point list 


11 


Starting segment nr. 


12 


Starting PB address 


13 


Starting address of STLT 


1U 


Starting address of FLOT 


15 


Rec. Nr. of external list 


16 


Starting SST Nr. 


17 


Starting address of trapcom. 



SFAGS 

SNRSEGS 

SGLOBALSIZE 

SGLOBALRECD 

SSEGHENTRECD 

SSTACKSIZE 

SDLSIZE 

SMAXDATA 

SENTRYRECD 

SSTARTINGSEG 

SSTARTINGADR 

SSASTLT 

SSAFLUT 

SEXTERNALRECD 

SSTARTINGSST 

SSATRAPCOM 



F ■ Fatal Error 

N ■ Non-Fatal Error 

Z - Zero DB 
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DIRECTORY ENTRIES 



01 l| 2| 31 U| 51 6| 71 8| 9ll0|ll|l2|l3lH»|15 



INWG 



I 
I 
I 
I 
16 

I 
I 



20 

I 
21 



|..|-_|_.|._|„|_.|..|„|..|..| 



I I I I 



NWG 



GARBAGE 



|10|11|12|13|1U|15 

l"l"|--| 

I M| | | 1 

l-l-l-l 



-FID- 



PVINFO 
CSTARRAY 



71 9 |10|11|12|13UU|15 

l-l-l-l 

I A| LIB | M| P| | 2 



l-l 



■ l-l-l-l 



-FID- 



CST block 


index 




fprocess 


sharing 




# segments 


in prog. 


file 


PVINFO 



GARBAGE (0) 



1 FREE SPACE 



SL FILE(l) 

Indicates which 
CSTs are being 
used for the 
segments of the 
SL file. 
PVINFO: 
: k- unused 
M:k- MVTAB inx 
8:8- vols mtd. 
(master = bit 15) 



Program File 
Directory (2) 



Indicates which 
CST's are being 
used for the 
segments of the 
program file and 
its internals. 
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DIRECTORY ENTRIES (CONT. ) 

I - " — I 

I lilUIIIIIUIIIIIIIUIIIIIIiUIIIIIUUIIIIIIH I 

i iiiiiiiiiiiiiiuiuuiiiiifiiiiiuiiuuiiiiiu i 

| CST bit map j 

I /////////////////////////////////////////////// | 
I lUllllllilllUlllillilUIIIIIIIIIIIIIIIIIIIUI I 

" I I 

A: set if program file is allocated 



|10|ll|12|13|ll»|15 



I M| P| | 
l-l-l-l 



-FID- 



|10|11|12|13UM15 

•I--I-I-I 

I M| P| | k 

l-l-l-l 



-FID- 



CREATER PIN 
(NOT USED) 



01 11 2| 31 U| 51 6\ 71 8| 9U0|11|12|13|1U|15 

-I I I l-l-l-l 

I M| P| | 5 

' l-l-l-l 



-FID- 



LOAD PROCESS STATUS 



LOADING (3) 



1 Indicates that 
the program 

2 file is being 
loaded. 



WAITER (1*) 



Indicates that 
a process is 
waiting for the 
program file to 
be loaded. 



L0ADED(5) 



Indicates that 
a program file 
has been loaded 
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|10|ll|12|13|lU|15| 

I SHARER(6) 



II I M| P| | 6 |0 
I--I--I-I I 

! PIN i Indicates that 

I4 1 1 1 a process is 



1 2 running the 
■FID j program file. 

13 
I 
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DIRECTORY ENTRIES (CONT.) 



1U 



12 



EXT 



CST ARRAY 



01 II 2| . 



|ll|12|13|li»|15 



■I--I-I- 
I I F| 

PIN 



1-1" 
176177 



I 



EXTENSION(7) 

Indicates that 
a process has 
loadproced a 
procedure. 



CST ARRAY (BIT MAP) 



DEFINITIONS 



NWG - #words in garbage entry. 



FID - file ID. 



LIB 
F 



word l-(0:8)=log dev# 

word l-(8:8)=msb of disc address 

word 2- s lsb of disc address 

0=SSL, 1=PSL, 2=GSL. 

CST array format (0=list, 1-bit map) 



H - executing mode, indicates whether the segments for the file 
have been copied onto the system disc (l=fast) or not (slow). 
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DEFINITIONS (CONT. ) 



T - 


entry type 





GARBAGE 


1 


SL 


2 


PROGRAM 


3 


LOADING 


k 


WAITING 


5 


LOADED 


6 


SHARER 


7 


EXTENSION 



self explanatory 

indicates which CST's are being used for segments 

of the file. Currently F=l and M=0 for all 

SL entries. 

indicates which CST's are being used for segments 

of the file and all its externals. Currently 

M=0 for all program entries. 

indicates that a program file (FID) is being 

loaded on behalf of a process (PIN). 

indicates that a process (PIN) is waiting for 

a program file (FID) to be loaded. 

transformed entry of type U that is used to 

return status of load. 

indicates that a process (PIN) is currently 

running a program file (FID). 

indicates that a process (PIN) has LOADPROCed 

a procedure (1<=EXT<=225). 



program mode bit=0 (normal) everything that should be in priv is 

in priv mode and likewise for non- 
priv mode. 
=1 (NOPRIV) everything in non-priv mode. 
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LOADER CACHE 



SYGLOB extension area + %J2 contains DST number of cache 
BUCKETSIZE = %52 



0| 
II 



CACHE DATA SEGMENT FORMAT 
HIT COUNTER 



21 
31 



U| 



U+ BUCKETSIZE | 



U+9U* BUCKETSIZE | 

I 
U+95* BUCKETSIZE -1 | 



BUCKET FORMAT 



| Length of 
| SLDIR1 +1 



1 I SLDIR 1 



| LENGTH OF 
I SLDIR2 + 1 

I SLDIR 2 



MISS COUNTER 
BUCKET 
BUCKET! 



BUCKET 9k 



Most recently referenced system SL 
directory entry from this SL directory 
bucket 



| Second most recently referenced entry 



| LENGTH OF | 
| SLDIRN + 1 | 



BUCKET | SLDIRN 
SIZE-lj 



| Nth most recently referenced entry; if 

| not complete then indicates end of 

bucket 
All bucket words are initalized to BUCKETSIZE +1, indicating 
no entries. 
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LOADER COMMUNICATION TABLE (LCT) SYSDB + f,220 



Form incoming to Loader 

.01 1| 2| 31 U| 51 6| 71 8| 9U0|11|12|13|1U|15 




1 
2 
3 
k 

5 
6 

7 
8 

9 
10 
11 
12 
13 
11* 

15 
16 

17 
18 

19 
20 
21 



I--I--I-I-I--I--I--I 



CMD | LIB | M| | L| 

I I-I--I- 

LOGICAL DEVICE # 



PROG PIN 



I 



DISC 



ADDRESS 
# CHARS IN NAME 



PROCEDURE 



NAME 



WAITER PCB INDEX 



|BA|IA|PM| 



|MR| |DS|PH 



GROUP 



NAME 



ACCOUNT 



NAME 



PVINFO (see "DIRECTORY ENTRIES") 



COMMAND 
PROGRAM FILE 
DESCRIPTOR 

CMD= loader cmd 
0=load prgm 
l=load proc 
2=alloc prog 
3=alloc proc 

L I B= library 
search 
0=SYS 
1=PUB 
2=GROUP 

M=NONPRIV MODE 
L-LOAD MAP REQ. 



USER CAPABILITY 
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LCT (COST.) 



Form returned to WAITER 


1 
2 

3 
U 

5 



| F.S. ERROR OR STARTING CST # 


i LOAD PROCESS ERROR NUMBER 


1 LOAD HAP FLAG 


i | LDEV 

j __ 


| DISC 

I ADDRESS 



TRUE IF LMAP 
PROVIDED 

\ 

I 

I LOAD HAP DISC 

I FILE DISCRIPTOR 
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CHAPTER 12 PRIVATE VOLUMES / SERIAL DISC 



MVTAB (Mounted Volume Table) 



DST %65 



111111 
0|l:2:3|U:5:6|7:8:9|O:l:2|3:fc:5 



max entries 



I 
171 

I 
181 

I 
19! 

I 
20| 

I 



ldev 



DIRBASE 



0| entry size 
I - 

1| # of mounted volume sets 
I 

2| 

I- 
31 

I- 
U| 

I- 
51 



of SYSTEM volume set 










1 

2 master volume of 
S7S VS is always 

3 ldev = 1. 

1* 
5 



121 

I 

1 22 

I 

1 23 
I 
\2k 



•- entry 
(MVTABX = 0) 
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HVTAB (COMT.) 



0|0:cycl:///////////////////////7 



l|hvol:nvol: 



ucnt 
ldev : DIRBASE 
of volume set 



I- 
21 

I- 
31 

I- 
U| 

I- 
51 

I 

6|///////////////: 

I 

I 



generation number 
ldev : VTABX 



vent 



191 
I 



ldev 



20|///////////////: 
I 

I 
I 
I 



VTABX 
vent 




1 

2 master volume 
of volume set 

3 is on this ldev 

k 

5 

| - vol entry 
6 I (double) 



I 



|-- entry 1 
(MVTABX = 1) 



23 I 

|- vol entry 7 
2U J (double) 



■- entry n-1 
(MVTABX = n-1) 
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MVTAB (COST.) 



I - 

| : cycl : //////////////////////// I 

I" 

1 | hvol : nvol : ucnt 

I " 

2 | ldev : DIRBASE 

I 

3 1 of volume set 



I- 
k\ 

I- 
51 

I 

61///////////////: 

I 

I 



generation number 
ldev VTABX 

vent 




1 
2 

3 
U 

5 I 

|- vol entry 

6 | (double) 



| — entry n 
(MVTABX - n) 



191 
I 



ldev 



20\/////////////// K 
I 



WABZ |23 I 

j- vol entry 7 
vent |2U j (double) 



cycl - cyclical volume index 
(local VTABX) for disc 
space allocation 

hvol - highest (ordinal) volume 

index (volume index being the 
volume set's local VTABX) of a 
mounted member of the volume 
set (class). 

nvol - # of volumes mounted for the 
volume set (class). 

ucnt - # of users having mounted 
the volume set. 

vent - f of users having mounted 
the volume. 
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FVUSER (Private Volume User Table) 



DST %66 



111111 
0|1:2:3|U:5:6|7:8:9|0:1:2|3:*»:5 

table size (words) 



I HII llllll llll: # of entries 



bitmask of MVTABX's represented 



maximum table size ( words ) 



available pointer 



op mask 



MVTABX 



max users : # pins 
current size of entry 



PV flags 
vmask 



I OP 



pin 



user bind count 
user mount count 



system bind count 
system mount count 



bind names count 
DST # of bind names segment 



vmask : pin 
user bind count 



user mount count 
system bind count 



system mount count 
bind names count 
DST # of bind names segment 




1 
2 

3 
U 



- entry head 
(U words) 



user entry 1 



- user entry 2 



-- table head 
(5 words) 



•- volume set 
entry 1 
(MVTABX = j) 
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PVOSER (CONT.) 



vnask 



pin 



user bind count 
user mount count 



system bind count 
system mount count 



bind names count 
DST # of bind names segment 



- user entry n 



op mask 



MVTABX 




— volume set 
entry n 
(MVTABX = k) 
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Bind Names Data Segment 
(Created and managed via PVUSER Table) 



111111 
0|1:2:3|U:5:6| 7:8:91 0:1:2|3:1»:5 



max segment length 



current segment length 



■- entry 



81 



01 



II 



I- 



21 
I 

31 
I 

I 
51 

I 
61 

I 
71 



I- 



bind count 



GROUP 
NAME 



ACCOUNT 
NAME 



1 10 



■- entry 1 
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BIND NAMES DATA SEGMENT (COHT. ) 



1 bind count j j 


1 |1| 
1- GROUP -j j 
1 | 2 | 
1- NAME -j j 

1 13 1 
1 1 U 1 


1 15 1 
1- ACCOUNT -j j 

> |6] 
1- NAME -| | 

1 17 1 
1 |10 | 

1 a j 

1 ▼ j 
1 a j 



i 

1 
a 
b 

1 

e 



entry n 
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SERIAL DISC GAP TABLE 



SECTOR ADDRESS OF START 


OF 


DATA 


UNUSED 


UNUSED 


UNUSED 


TYPE| 


SECTOR ADDRESS 






TYPE| 


SECTOR ADDRESS 







GAP TABLE HEADER 



ENTRY (2WD.) 



ENTRY (2 WD.) 



TYPE: 



- END OF FILE MARK 

1 - LAST RECORD PHYSICALLY WRITTEN 

2 - START SECTOR OF "HOLE" 

3 - END SECTOR OF "HOLE" 

U - START SECTOR OF "CONTIGUOUS BLOCK" 

5 - END SECTOR OF "CONTIGUOUS BLOCK" 

6 - END OF TAPE MARK 

7 - END OF TABLE MARKER 
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SERIAL DISC PACK FORMAT 



1 DISC LABEL ) 


1 DEFECTIVE j 
j TRACKS TABLE | 


I RESERVED j 


! GAP TABLE 


| GAP TABLE 1 
j EXTENSION AREA j 

TrtAH DrtTUT>l ------------------------------I 


j DATA STORAGE j 

| AREA | 
END OF >| j 

TAPE REFL. | DATA OVERRUN 1 



TRACK SECTOR 



TRACK SECTOR 1 



TRACK SECTOR 2-3 



TRACK SECTOR k 



REST OF TRACK 



TRACK 1 SECTOR 

through 
LAST TRACK -1 

LAST TRACK 
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CHAPTER 13 



I/O 



IOQ* 
•>| FLAGS I 
I IOQP I 
-I |LDEV I 



I 



I 



I 



I DLT |<- 
I I 

I I 



DRQ for disc requests 



•>/ 

\ 



LOGICAL \ I/O TABLE LINKAGE 
DEVICE / — 



DITP 
FLAGS 



FLAGS 
DITP 
IOQP* 
UNIT|LDEV 
DLTP 
ILTP 



LPDT 



DIT 



I 



ILT 



--> 



Ch| |DRT I 

SIOP I 

UNIT EXTRACT 



SIOP I Q # I 
SIZE I I 



I 



+UNIT 



DITP 



SIO PROG AREA 
DRT I 
SIOP I 

PI I 

ILTP I 
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DEVICE REFERENCE TABLE (DRT) 



(SERIES II/III) 




SIOP - absolute address of SIO program 

PI - interrupt handler plabel 

DBI - this is the absolute address of the ILT 



ABS 


(/33, AU) 


8 


1 Bank of DRT 1 


9 


1 Offset of DRT in Bank j j 




DRT ENTRY ON /33, /kk | 




SIOP | « j 




DBI | 




PI | 




Channel Flags j 
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DRIVER LINKAGE TABLE (DLT) DST %1J 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 



I-I-I-I--I--I--I-I-I 



■I-I--I--I-I- 



QUEUE NUMBER 



| DF | MC | CR | |0 |MTYP 
I (SEE BELOW) 



MONITOR PLABEL 



INITIATOR PLABEL 



COMPLETOR PLABEL 



INTERRUPT PLABEL 



DIT SIZE 



DEVICE TYPE 



CS DRIVER EDITOR PLABEL 



INITIALIZATION PLABEL 



DPROC 
DMNTR 
DINIT 
DCOMP 
DINTP 
DTYPE 



There is one DLT for each type of driver. A pointer in the DIT allows 
different devices on a controller to have different drivers and 
interrupt handlers. 



DPROC. QNUMB 

.(8:1).DRVRFRZN - 
(DF) 

.(9:1).MAMERR0RC- 

(MC) 
,(10:1).C0RERES - 

(CR) 
.(lU:2).DRVRTYPE- 

(MTVP) 



This field contains the I/O process request queue 
number for type 2 drivers . Zero for all other types . 
Driver code frozen. Set by MAM when then the driver 
code segment has been made present and frozen from a 
request from SIODM. 
MAM Error on Code Makepresent 

If set both initiator and completor code are core 
res ident . 
DRIVER/MONITOR TYPE 

- not used 

1 - driver can be executed on any stack 

2 - driver can be executed in the user process or 

in the I/O process identified by IDNUMB 

3 - run only in process whose PCB number is in 

IDNUMB 



DMNTR - I/O Monitor Plabel. 

DINIT - Driver Initiator Procedure Plabel. 

DCOMP - Driver Completor Procedure Plabel. 

DINTP - Special interrupt hauler Plabel. This procedure is called 
by GIP if ISPEC is set DFLAG. No other action is taken by 
GIP except to set the Interupt Status in DSTAT. 

DTYPE. DITSIZE - The length of the DIT in words for this driver. 
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LOGICAL PHYSICAL DEVICE TABLE (LPDT) 



HIGH ENTRY # 



ENTRY SIZE 



SERV. REQ INT 



same 



HI 

|1|0| 



XDD INDEX 



same 



HI 



same — 



LPDTDST=%15 
LPDTSIR=%11 



\ 



| NORMAL DEVICE ENTRY 

I 

/ 



\ 
I 
I 



I 

I 

/ 



VIRTUAL DEVICE ENTRY-ASSIGNED 
10 = IDD 
= 1 ODD 



VIRTUAL DEVICE FREE ENTRY 
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LPDT (CONT.) 



LPDT ENTRY 
2 3 4 5 



9 10 11 12 13 14 15 



I V | 
I FLAGI 



1 jDRSTATE 
I 



DITP/VIRTUAL DEVICE INFORMATION 



I I CY| | 
| | — |DUP|INTR| 
|JOBS|DATA|BOT| | 

| | PV| M | RV 



EOF 



|BR| | 

| |DR| SUBTYPE 

I--I-H 
|SF|FS| 



There is one two-word entry in the LPDT for each Logical Device. 

The base of the entry for a given Logical Device is equal to the 
Logical Device number multiplied by two. The physical device 
characteristics are maintained in the DIT and ILT. 

The field definitions for each entry are: 

WORD — 

VFLAG - Virtual device flag 

DITP - When VFLAG = 0, SYSDB relative pointer to the DIT 

1, Virtual device information 

WORD 1 — 

The following fields are defined for all devices: 

DRSTATE - Device Recognition State 

0-Not owned 

1-Owned or recognized 

2-Service requested - set by driver upon unexpected 

interrupt and awake DEVREC 

3-Service granted - set by DEVREC 
(sequence for logon: 0-2-3-1) 
JOBS - Accepting Jobs or Sessions 
DATA - Accepting Data 
EOF - End of File condition 

0-No EOF 

1-HARDWARE EOF 

2-: DATA 

3-:E0D 

4-: HELLO 

5-: BYE 

6-: JOB 

7-:EOJ 
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LPDT (CONT.) 



SUBTYPE - Device subtype. For tapes, the SUBTYPE is divided into two 
subfields as follows: 



H0RD1.(13:3) - actual device subtype 
W0RD1.(12:1) - = operator allocation 
1 = automatic allocation 



The definitions for bits 4,5,6,10, and 11 in word 1 are device dependent. 

For terminal-like devices only, 

CY - Control Y is allowed and has been detected 

BR - Break detected or ignore break if main running 

For tape drives only, 

BOT - Tape is at load point or no tape mounted 
DR - DEVREC is performing Automatic Volume Recognition (AVR) on 
tape drive or suppress AVR on job/data-accepting tapes 

For all devices except non-system domain discs, 
DUP - Duplicative 
INTR - Interactive 

For non-system domain disc drives only, 
PV - Private volume 
M - Mounted volume 

RV - Reserved volume for multiple pack mount requirement 
SF - Serial or foreign disc physically and logically mounted 
FS - If SF = 1, then: FS = 0, Serial disc 

FS = 1, Foreign disc 
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LPDT (CONT.) 



| ! V--=0 then DITPOINTER 
0| VJ V=l then Virtual Device Entry Info. 



II 



as before -■ 



The first word of each entry in the LPDT has changed to reflect 
the addition of Virtual Devices. 

A "real" logical device (ie. one on which an ATTACHIO call may he per- 
formed) has the sign bit set to "zero". 

A "virtual" logical device has the sign bit set to "one". Thus any- 
one who loads the DIT pointer for use must check this sign bit. 



13-6 



OVERVIEW OF DEVICE TABLES 



" — 1< DST %16 

LOGICAL DEVICE TABLE 
LOT 



DEVICE CLASS TABLE 



LOGICAL DEVICE TABLE 

EXTENSION 

LDTX 
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DST 16(8) = U(10) 
SIR 12(8) = 10(10) 



LOGICAL DEVICE TABLE 
(Indexed by Log Dev#) 

ZERO ENTRY FORMAT 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

0| HIGHEST ENTRY # | ENTRY SIZE=5 
| 

| POINTER TO FIRST DEVICE CLASS ENTRY 
1| (RELATIVE TO TABLE BASE) 



21 
I" 
31 



NUMBER OF DEVICE CLASS ENTRIES 
SIZE OF DEVICE CLASS TABLE 



, 

4 1 /////////////////////// 1 STREAMS DEVICE NUMBER 
I 



TYPICAL ENTRY FORMAT 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

FILE USE COUNT |0 
1 



VOL TABLE INDEX IF DEV ! 

TYPE<8 OTHERWISE * | 

MAIN PROCESS PIN # | 



CONTROL Y PIN 



| *or process # of 

|1 I/O spooler for 

this device 



RECORD WIDTH |CS|FO| DEVICE TYPE \Z 
1 

| | | | | | | DEFAULT OUTPUT DEVICE | 



SS | F| M| R| |HT| C| OR CLASS INDEX(C=1) 



MISC 



Ql 



VDD INDEX 



I 
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LDT (CONT.) 



SS. 



sq = : 
c . . 

F . . 
M . . 

R . . 
MISC. 



spool state 

not spooled reserved 

1 spooled input for 

2 spooled output spooling 
SPOOLING ENABLED 

default device is class index CS 
avail to system FO 

avail to diagnostics HT 

down requested 



miscellaneous information, device dependent: 



CS device 
Special Forms 

= Header/Trailer on 

1 = Header/Trailer off 



1) 
2) 



For terminal-like devices, default terminal type to be used when 
not specified in HELLO command. 

For variable density tape drives, contains density information. 
WORD4.(l:3) ~ aetual tape density 

= density not yet determined 

1 = 1600 BPI 

2 = 6250 BPI 

WORD4.(4:3) — density requested in FOPEN for writes to tape, 
unlabelled tapes only 

= no FOPEN with write access yet 

1 = 1600 BPI 

2 = 6250 BPI 
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DEVICE CLASS TABLE 
(Sequentially Organized) 

TYPICAL ENTRY FORMAT 
l 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 



0| 

I 

II 

2| 
I 

31 
I 



CLASS NAME 



1*| //I CYCLICAL POINTER |SQ| T| CLASS ACCESS TYPE 



5l#OF DEVICES IN CLASS (N)| 



DEVICE #1 
DEVICE #3 



T=TERMINAL 
ACCESS 
BIT 



N/2+6- -> | 




SQ = Spool Queue bit 



NOTE: The device class table is in the same data segment (DST 16(8) 
as the LDT. ie. , the LOT consists of three separate tables. 

1. logical device table and 

2. device class table 

3. LDT Extension 
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LOGICAL DEVICE TABLE EXTENSION 



DST 16 = U 

8 10 

SIR 12 = 10 

8 10 



ZERO ENTRY 
1 2 3 4 5 6 7 8 9 10 11 12 13 H 15 



0| HIGHEST ENTRY # | 
, 

II 



21 

I- 
31 

I 
41 

I- 



ENTRY SIZE 



TYPICAL ENTRY 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



S I 



TBRC 



SERIAL DISC BUFFER XDS # 



Reserved 
Reserved 



S Seek ahead enable/disable flag. 

TBRC Terminal's baud rate code 
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INTERRUPT LINKAGE TABLE (ILT) 



DST %52 



ILT FOR SERIES II/III 
1 2 3 U 5 6 7 8 9 10 11 12 13 I 1 * 15 

+ __ + _.+- _ + --. + _-+--+-- + + _- + -- + -- + -- + -- + -- + -- + --+ 

| I 



1 


1 




+• 


2 


1 




+ 


3 


1 




+■ 


U 


1 



I 

-+ 

I 

-+ 



I 

-+ 

I 

-+ 



I 



DRT NUMBER 



5 l" 0_ 

6 I 
+ 

7 | H| CHANQUE I 
+ + 

%10 ISYSDB relative pointer to I/O program area. I 
+ + 

jUl | I 

+ — ... — — + 

%L2 | single instruction that is executed to extract | 
| the device unit number from the status. I 
+ ♦ 

JH3 I I 

+ - + 

%1U | SIOPSIZE I CQUEN I 
+ + 

%15 I o » 

+ + 

%l6 | SYSDB relative DIT pointer for unit I 

+ - + 



ICPVAO 

ICPVA01 

ICPVA02 

ICPVA03 

ICPVAOU 

ICPVA05 

ISRQL 

IDRTN 

ISIOP 

ISTAP 

IUNIT 

ICDP 
IQUEUE 
IFLAG 
IDITPO 



| SYSDB relative DIT pointer for unit n 
+ 

I Seekmask (Disc only) 



I/O 
Program 
Area 



SIOPSIZE - SIO PROGRAM SIZE / 2. 



| IDITPN 

-+ 
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ILT FOR SERIES 30/33/M i SERIES II/III (HP-IB) 

1 2 3 k 5 6 7 8 9 10 11 12 13 lfcl5 

I Channel , IcpVA0 

2 ^SfT, I ICPVA01 

2 Variable , IcpVA02 

3 { ™!!._.! ICPVA) I ICPVA °3 

5 ; ^!!!!._ i ICPV *o5 

6 | _„_ ° i ISR » 

7 !."!_ ^^Q^ I I CHAM | DEV | ICNTRL 
%10 ISTSDB relative pointer to channel program area. | ISIOP 
%11 |SYSDB relative pointer to status return area. | ISTAP 

%12 | single instruction that is executed to extract | IUNIT 
I the device unit number from the status pointed I 
|to by ISTAP. 

, t " I 

*13 ISYSDB relative DIT pointer of the device | ICDP 
(currently using the channel to perform a data I 
I operation. i 

+ ; 

^ l__ SIOPSIZE | CQUEH | IQUEUE 
%15 |RW|WP|IG| | HCUHIT | IFLAG 

%16 | SYSDB relative DIT pointer for unit | IDITPO 

■ 

+ 

+ 

ISYSDB relative DIT pointer for unit n | IDITPN 

I Program status return area I 

I pointed to by ISTAP i 

+ " 

, + 

I Seekmask (Disc only) j 

J I "/°" " I 

l Program i 

I Area i 

+ 

+ 



13-12 



ILT (cont.) - TERMINOLOGY 

IPCVA - These four words comprise the channel program 

variable area where information is stored concerning 
a channel program Interrupt instruction or abort. 
CPVAO should be used only for channel program aborts. 
ICPVAU - Words U and 5 contain DMA address, when channel program 

aborts during DMA transfer. 
ISRQIi - Serial poll request queue length. Series 33 currently 
does not support any serial poll devices. This should 
always be zero. 
ICNTRL - Contains controller information. 

.M If set, the controller is sharing a software channel 
resource in order to limit bandwidth. 
.CHNQ The software channel resource number. 
.DRTN The DRT number for a Series 33 device is equivalent to: 

.CHAN - channel number (k most significant bits of DRTN) 
.DEV - device number (3 least significant bits of DRTN) 
IFLAG - Used for controller flags. 

.RW Runwait flag. An idle channel program should be started 

when there are no active requests to process. 
•WP Waitprog flag. An idle channel program has been started 
for this controller. This bit is reset by an interrupt. 
.IG Ignorehi flag. An HIOP instruction has been issued against 
this controller, but the channel program was not in a 
wait statement. Therefore, ignore the interrupt generated 
by the channel code when this program halts. 
.HCUNIT Highest configured unit number for this controller. 
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DEVICE INFORMATION TABLE (DIT) 



There is one DIT per physical device. If a physical device represents 

represents more than one logical device, the logical device 

number is obtained from the I/O queue element. 

Although details of DIT's vary with device, the following 

structure is common to all: 

DIT for Series II /III 

1 2 3 *4 5 6 7 3 9 10 11 12 13 I 1 * 15 

|T |D |AC|RQ|SI|MU|SP|IO|IA|NO|ST|NS| STATE | DFLAG 

1 |SYSDB relative pointer to the DIT for the next | DLINK 

| device requesting this resource or service | 
+ + 

2 |SYSDB relative pointer to the first IOQ in | DIOQP 
j request list for this device j 

+ - — -+ 

3 I IOT | Phys. unit # | Logical device number | DLDEV 
+-- - - + 

U ISYSDB relative pointer to Device Linkage Table | DDLTP 
+-- + 

5 ISYSDB relative pntr to Interrupt Linkage Table | DILTP 
+ - - + 

6 (Controller hardware status | DSTAT 
+ __ + 

7 | Hardware error status. Set when the driver | DSERR 

I detects an error. Whenever <>0, the driver j 

| monitor logs an I/O error and clears this wordj 
+ + 

I Device Dependent Area | (DTIME) 

+ + 
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DIT TERMINOLOGY (SERIES II/III) 



DFLAG - DEVICE RELATIVE FLAGS 
T SET IF DEVICE IS A TERMINAL. 
D SET IF DEVICE IS A DISC. 
AC ACTIVE BIT. 1 IMPLIES A MONITOR CURRENTLY SERVICING 

THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED WHILE 

MONITOR IS ACTIVE. 
MU IF SET, MULTIPLE UNIT CONTROLLER. 

10 IF SET, THEN A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
I A IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
NO IF SET, DEVICE IS IN A NOT READY OR OPERATOR WAIT. 
SI SPECIAL INTERRUPT HANDLER 
SP SIO PREEMPTION 
ST START WAIT CHANNEL PROGRAM 
NS DO NOT SHORT WAIT THIS DISC 
STATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 

ALLOWABLE STATES ARE: 

- START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COMPLETOR 

U - NOT USED (BUT RESERVED) 

5 - COMPLETE REQUEST 

6 - UNEXPECTED INTERRUPT OCCURED 

7 - START OPERATOR INTERVENTION WAIT 
%10 - WAITING (ON OPERATOR) . RESTART AT 
JfcLl - WAITING (DATA MAKEPRESENT/FREEZING) 

5fcL2 - WAITING (INITIATOR CODE MAKEPRESENT/FREEZE) 
5tL3 - WAITING (FOR COMPLETION INTERRUPT) 
%lk - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 
JH5 " NOT USED (BUT RESERVED) 
%16 - WAITING (INITIATOR CODE MAKEPRESENT) 
%17 - WAITING (COMPLETOR CODE MAKEPRESENT) 
IOT - I/O System type O-Series II/III I/O System 

1-HP-IB 

2 -unused 

3 -unused 
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DIT FOR SERIES 30/33/UU 

1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 

|T |D |AC|RQ|SI|MU| 0|IO|IA|N0|STlNS| STATE | DFLAG 
+ — +--+--+--+ — +--+ — +--+ — + — + — +--+ — +--+__+__+ 

1 |SYSDB relative pointer to the DIT for the next | DLINK 
I device requesting this resource or service j 

+ - + 

2 ISYSDB relative pointer to the first IOQ in | DIOQP 
| request list for this device j 

+ + 

3 I IOT | Phys. unit # | Logical device number | DLDEV 
+ + 

k |SYSDB relative pointer to Device Linkage Table | DDLTP 
+-- + 

5 ISYSDB relative pntr to Interrupt Linkage Table | DILTP 
+ + 

6 | Controller Hardware Status | DSTAT 
+ + 

7 I Hardware error status. Set when the driver | DSERR 
| detects an error. Whenever <>0, the driver | 

| monitor logs an I/O error and clears this wordj 

+-- - - + 

I Device Dependent Area | (DTRQX) 

+ + 

DTRQX Used by some device drivers, it denotes timer 
request index. 
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DIT TERMINOLOGY (SERIES 30/33) 



DFLAG - DEVICE RELATIVE FLAGS 
T SET IF DEVICE IS A TERMINAL. 
D SET IF DEVICE IS A DISC. 
AC ACTIVE BIT. 1 IMPLIES A MONITOR CURRENTLY SERVICING 

THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED WHILE 

MONITOR IS ACTIVE. 
MU IF SET, MULTIPLE UNIT CONTROLLER. 

10 IF SET, THEN A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
I A IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
NO IF SET, DEVICE IS IN A NOT READY OR OPERATOR WAIT. 
ST IF SET, AN IDLE CHANNEL PROGRAM SHOULD BE STARTED FOR 

THIS DEVICE. 
SI SPECIAL INTERRUPT HANDLER 
NS DO NOT SHORT WAIT THIS DISC 
STATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 

ALLOWABLE STATES ARE: 

- START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COMPLETOR 

U - NOT USED (BUT RESERVED) 

5 - COMPLETE REQUEST 

6 - UNEXPECTED INTERRUPT OCCURED 

7 - START OPERATOR INTERVENTION WAIT 
%10 - WAITING (ON OPERATOR) . RESTART AT 
%11 - WAITING (DATA MAKEPRESENT/FREEZING) 

%12 - WAITING (INITIATOR CODE MAKEPRESENT/FREEZE ) 
JH3 - WAITING (FOR COMPLETION INTERRUPT) 
%ll» - WAITING (FOR DEVICE CONTROLLER AVAILABILITY) 
%15 - HOT USED (BUT RESERVED) 
%16 - WAITING (INITIATOR CODE MAKEPRESENT) 
%17 - WAITING (COMPLETOR CODE MAKEPRESENT) 
IOT - I/O System type O-Series II/III I/O System 

1-HP-IB 

2-unused 

3-unused 
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DIT for SIO Devices 

1 2 3** 5 6 7 8 9 10 11 12 13 lU 15 
1 - | 

1 TERM | DISC | ACT | REQ | | M | SIO | 10 |IAK| M | NT | | STATE |DFLAG 
I I I I I | UNIT | PREMP|PROG| |READ|RY| | | 

I — | 

ll NEXT DITP IDLIHK 

21 IOQP IDIOQP 

I " - — | 

31 IOT | UNIT | LDEVN |DLDEV 

' I 

*»l DLTP JDLTP 

' " I 

51 ILTP IDILTP 

' " - " " I 

o| Controller Hardware Status jDSTAT 

J I 

71 Hardware Error Status |DSERR 

J I 

°\ |DTRQX 

! ! 

I DRIVER DEPENDENT DIT AREA I 



DFLAG. TERMINAL - Device is a terminal 

.DISC - Device is a Disc (Bit 0=0) 

.ACTIVE - A monitor is currently servicing this device 

.REQUEST - Service requested while monitor was active 

.MUNIT - device controller servicing multiple units 
.SIOPREMPT- If set then a preemptive request has been queued for 
this device. Preempt code is set in IOQ. 

- I/O program in progress. Decrement SI0C0UNT and 
check for mult i- channel when complete 

- Interrupt or Response has occurred. 
-Moving head disc 
-Not ready for SIO. SIODM holds off next SIO until 

ALLOWPOLL is done. 



. IOPROG 

.IAK 
.M HEAD 
.NT RDY 



DTRQX 



Used by some device drivers, it denotes timer 
request index. 
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DIT FOR SIO DEVICES (CONT. ) 



DFLAG. STATE - this quantity specifies the next action to be taken 
in servicing the request. 

0-new - start request. 

1-not used. 

2-call Driver Initiator Procedure 

3-call Driver Completor Procedure 

5 -complete request 

6-device recognition 

7-start operator intervention wait (%10) 
%10-restart request on interrupt 
%11-wait for data to be frozen then state 2 
%12-wait for driver code to be frozen then state 2 
%13-call completor on interrupt 
JlilU-wait for device controller 
%15-not used 

%l6-wait for initiator make present then state 2 
%17-wait for completor make present then state 3 



DLINK 
DIOQP 

DLDEV.LDEVN 
.UNIT 
.IOT 

DDLTP 

DILTP 

DSTAT 

DSERR 
DTIME 



SYSDB relative pointer to the DIT for the next device 

requesting this resource or service. 

SYSDB relative pointer to the first IOQ in the request 

list for this device 

Logical Device Number 

unit number of the physical device. 

10 type 0=> Series III I/O, 1=> HPIB I/O 

S7SDB relative pointer to the DLT. 

S7SDB relative pointer to the ILT. 

interrupt status for this device. 

device interrupts. 

Hardware Device Controller Status. 

detects an error, whenever not zero SIODB logges an 

I/O error and clears this word. 

time out completed flags. If a timeout occurs in response 

to a timer request type %20 (I/O request), the sign bit 

is set in this word. The IA bit in DFLAG is also set, 

and the monitor for this device is awakened. (Only used 

if timer services are requested. Must be word #8 if timer 

services are requested.) 



Set each time the 
Set when the driver 
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DIT FOR FIXED HEAD DISK 





12 


3 


*» 5 6 7 8 9 10 11 


12 15 




0| 1|ACT|REQ| 


| 0| 0|I/0|IAK| | 0| 0| 


STATE j 


11 


* 




NEXT DITP 




2| 




CURRENT REQUEST SYSBASE INDEX 




31 


IOT | 




i LDEVN | 


M 






DLTP 




51 






ILTP 




61 






DEVICE STATUS 




71 






DEVICE STATUS (ERROR) 




8| 


SYSBASE 


INDEX OF FIRST REQUEST IN QUEUE 




91 


SYSBASE 


INDEX OF LAST REQUEST IN QUEUE 




10 1 






XFER COUNT 




11| 






LOGICAL DISK ADDR 




12 1 






SYSBUF ADDRESS 










ERROR & RETRY INFORMATION 






1 1 
B| W| 




1 
1 


RETRY j 
COUNT j 













DFLAG 

DLINK 

DCURRREQP 

DLDEV 

DDLTP 

DILTP 

DSTAT 

DSERR 

DQHEAD 

DQTAIL 

DXFER 

DDADR 

DSYSBA 



QMISC 
OF IOQ 



IOT - I/O Devices 

- Series II/III 

1 - HP-IB 
3 - unused 
k - unused 

B - modify bad track table 
W - write bad track table 
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DIT FOR 790OA & 2888A MOVING HEAD DISC 

1 2 3 ** 5 6 7 8 9 10 11 12 15 





--I--I — 1 — 1 
0| 1|ACT|REQ| 

1 1 1 1 


— 1 1-1— -1 — 1 — I--I-I 

| M | | I/0|IAK| 1 | 0| 0| STATE 
IUNIT | |PROG| | I I I 




l! 


NEXT DITP 


2| 


CURRENT REQUEST SYSBASE INDEX 


31 


IOT | 




UNIT | LDEVN 




U| 


DLTP 


51 


ILTP 


61 


CURRENT DEVICE STATUS 


71 


DEVICE ERROR STATUS 


81 


SYSBASE INDEX OF FIRST REQUEST IN QUEUE 


91 


SYSBASE 


INDEX OF LAST REQUEST IN QUEUE 




10 1 

111 


CURRENT DISC 
ADDRESS 


12| 
131 


ALTERNATE TRACK 
DISC ADDRESS 


1U| 


CURRENT CYLINDER 


151 


• 




CURRENT DATA BUFFER ADDRESS 




16! 






NEXT DATA BUFFER ADDRESS 




17 


WORD COUNT REMAINING 


18 


CURRENT WORD COUNT 


19 


SYSBUF ADDRESS 



DFLAG 

DLINK 

DCURRREQP 

DLDEV 

DDLTP 

DILTP 

DSTAT 

DSERR 

DQHEAD 

DQTAIL 

DADR 

DALTADR 

CURCYL 

DBUFF 

DNXTBUFF 

WCR 

CWC 

DSYSBA 



IOT - I/O Devices 

- Series II/III 

1 - HP-IB 
3 - unused 
U - unused 
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ERROR & RETRY INFORMATION 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

I I I I I I I ! I | RETRY | 

I M| R| W| T| A| X| C| S| 0| COUNT I QMISC OF IOQ 

I-I--I--I--I-I--I--I--I — -| | 

M - handling defective track map A - reading alternate track 

R - read defective track map X - xfer from alt. track 

W - write defective track map C - recalibration done 

T - track to track xfer S - seek or recal in progress 
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DIT FOR 7905/7906/7920/7925 



o| 


1 2 3 U 5 67 8 9 10 11 12 15 
__|__|___|__.|___| ,..|....|...|„.|..|. -I- — | 

0| 1|ACT|REQ| | M | 0| I/0|IAK| 1 | 0| 0| STATE | 
| | | | IUNIT | IPROGI | | | | i 


ii 


NEXT DITP i 


2| 


CURRENT REQUEST STSBASE INDEX 


31 


IOT | UNIT | LDEVN | 


M 


DLTP ! 


51 


ILTP | 


6| 


CURRENT DEVICE STATUS | 


71 


ERROR DEVICE STATUS j 


81 


SYSBASE INDEX OF FIRST REQUEST IN QUEUE | 


91 


STSBASE INDEX OF LAST REQUEST IN QUEUE 


10 1 
111 


CURRENT LOGICAL | 
DISK ADDRESS j 


12| 
131 


CURRENT PHYSICAL | 
DISK ADDRESS | 


lk\ 


CURRENT DATA BUFFER ADDRESS | 


151 


WORD COUNT REMAINING 


16 1 


CURRENT WORD COUNT | 


171 


SYSBUF ADDRESS | 


18| 


STATUS 1 RETURN j 


191 


STATUS 2 RETURN j 


20 1 

41 j 


CYL I 


22 1 


HEAD | SECTOR | 


231 


STATUS 1 RETURN | 


2U| 


CYL | 



DFLAG 



1 


DLINK 




DCURRREQP 


3 


DLDEV 


k 


DDLTP 


5 


DILTP 


6 


DSTAT 


7 


DSERR 




DQHEAD 




DQTAIL 


12 




13 


CLDA 


1U 


CURCUL 


15 


CPDA 


16 


CDBA 


17 


WCR 


20 


CWC 


21 


SYSBUFA 


22 


STAT1 


23 


STAT2 


2U 






CEDA 


^%i» 

*? 




26 




\ 




271 

1 




301 
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DIT FOR 7905/7906/7920/7925 (CONT. ) 

i-.:::::::::::::::::::::: , , 

251 HEAD I SECTOR J31| 

' I REQUEST 

26 DISPLACEMENT |32 SYNDROME 

' 1 I 

271 PATT 1 |33| 

'" " I I 

281 PATT 2 |3U| 

I" I I 

291 PATT 3 |35l 

I — — - I / 

30 1 SCOUNT (SECTOR COUNT) j 36 

31 | " " | 3 7 

! INITIALIZE ADDRESS I 

321 , 38 

I I 

331 POINTER TO THIS DIT'S STATTAB WORD j 39 

1 - I 

IOT - I/O Devices 

- Series II/III 

1 - HP-IB 
3 - unused 
U - unused 



ERROR (t RETRY INFORMATION 
1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

S| E| M| W| 0| 0| C| 0| 



I D| 



QMISC OF IOQ 



D - retry determination 

S - request syndrome 

E - request error info 

M - update track map 

W - writing track map 

C - issued a re calibration 
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DIT FOR 7970 MAG TAPE 



1 2 3 U 5 


6 7 8 9 


10 11 12 15 


| Oj 0|ACT|REQ| | M 
1 1 1 1 1 IUKIT 


I 0| I/OIIAKI | 
1 IPROGI | | 


0| 0| STATE 
1 1 


1| 


NEXT DITP 




2| 


IOQP 




31 IOT | UNIT 


1 


LDEV # 


1*1 


DLT PTR 




51 


ILT PTR 




6|RW|RU|SH|CE|DC| 


HARDWARE STATUS 




71 


ERROR STATUS 




8| TIMEOUT FLAGS 


91 




13|RBU| RW 


10 | TIMER 


REQUEST INDEX 





DFLAG 

DLINK 

DIOQP 

DLDEV 

DDLTP 

DILTP 

DSTAT 

DSERR 

DTIME 

DDFLAGS 

DTRLX 



IOT - I/O Devices 

- Series II/III 

1 - HP-IB 
3 - unused 
k - unused 



DSAVE - Device 
RW RWBIT - 
RU RWUNLD - 

SH SHORT - 



CE CESTAT - 
DC DSFLAG - 

RW - (DDFLAGS, 
RBU - (bit Ik) 



processing flags 

Indicates tape has been rewound. 

Indicates that a rewind/unload was performed to allow a 

write-ring mount. 

A short read is in progress. After completion of read, 

EOF is checked for and if not present, the requested 

bytes are trans fered from the short -read buffer to the 

user's buffer. 

Channel parity error processing is in progress. 

Transfer used data chaining - used for computing the 

transmission log. 

bit 15) if set, tape is rewound 

if set, need to rewind tape before next write 
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QMISC 
1 2 3 U 3 6 7 8 9 10 11 12 13 lU 15 



| FORWARD | BACK 
U| SPACE I SPACE 
I COUNTER J COUNTER 



RETRY 
COUNTER 



I 
G| E 

I 



Where 

R - retry in progress 

B - backspace in progress 

F - forward space in progress 

G - gap in progress 

E - backspace on data end-of-file 

S - short read in progress 

U - unload tape for write ring installation 



13-26 



DIT for 7976 Magnetic Tape 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element. The following diagram shows the DIT used for 
the mag tape driver. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 MNEMONIC 
+ — + — + — + — + — + — + — + — + — + — + — + — + — + — + — + — + 

0| 0| 0|AC|RQ| 0|MU| 0|IO|IA| 0| 0| 0| STATE | DFLAG 
+ — + — + — + — + — + — + — + — + — + — + — + — + + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

I device requesting this resource or service | 

+ + 

2| SYSDB relative pointer to the first IOQ in | DIOQP 

j request list for this device I 

+ + + + 

3| | Phys. unit # | Logical device number | DLDEV 
+ + + + 

41 SYSDB relative pointer to Device Linkage Table | DDLTP 

+ + 

5| SYSDB relative pntr to Interrupt Linkage Table | DILTP 
+ + 

6|RW|RU|SH| |DC|PF| I DSAVE 

+ + 

7 | Hardware error status. Set when the driver | DSERR 

j detects an error. Whenever <>0, the driver j 

I monitor logs an I/O error and clears this wordj 

+ — + — + — + — + — + + 

JU0| Bit is set at completion of timer | DTIME 

+ — + — + — + — + — + + 

%11| Interrupt status for this unit. Set by the | DSTAT 

j driver each time it processes an interrupt. | 

+ + 

J512| Holds the time out request entry index while | DRQST 

j a timer is active. I 

+ + 

#131 Error log. Contains 5 valid bytes of status I DLOGERROR 

+ + 



DFLAG - Flags and request state 

xiv nvx j. v jq £X luvvxix wa xo v.ui x ran wj-jr ow* vavau^ vuxu «c v a%*w • 

RQ REQUEST - A service request is pending while the monitor is 
active. 

This device is on a multi-unit controller. 
An I/O Channel Program is running for this device. 
An interrupt or response has occurred for this device. 
Go to state %10 after Idle Channel Program is started. 
The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 



MU MUNIT 

10 I0PR0G 

IA IAK 

NO NOTRDY 

ST STWAIT 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 

4 - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

JS10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%14 - wait for controller, then call driver initiator 
%15 - not used 

%16 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 



DSAVE - Device processing flags 

RW RWBIT - Indicates tape has been rewound. 

RU RWUNLD - Indicates that a rewind/unload was performed to allow a 

write-ring mount. 
SH SHORT - A short read is in progress. After completion of read, 

EOF is checked for and if not present, the requested 

bytes are transfered from the short-read buffer to the 

user's buffer. 

DC DSFLAG - Transfer used data chaining - used for computing the 

transmission log. 
PF POWER - Device power up indication. 
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DSTAT - Mag tape controller status 

BITS USE 

END OF FILE (EOF) 

1 BEGINNING OF TAPE (BOT) / LOAD POINT (LP) 

2 END OF TAPE (EOT) 

3 SINGLE TRACK ERROR (NOT LOGGED FOR READS) 

4 COMMAND REJECT (REJECT) 

5 FILE PROTECT (NOT WRITE ENABLED; NO WRITE RING) 

6 MULTIPLE TRACK ERROR (MTE) 

7 UNIT ONLINE 

8 GCR (6250 BPI DENSITY) 

9 UNIT NUMBER (MSB) 

10 UNIT NUMBER (LSB) 

11 TIMING ERROR 

12 TAPE RUNAWAY 

13 REWINDING * 

14 UNIT BUSY ** (REPORTED AS UNIT NOT READY) 

15 INTERFACE BUSY * 
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TERMINAL DIT 



1 2 3 h 5 6 7 8 9 10 11 12 13 ll» 15 
DFLAG FOR A READ: 






TRM|UP |ACT|REQ|SIH|SPG|WWT|PR | HWL | PTY | TCH | BRD | DSTATE 




DFLAG FOR A WRITE: 





TRMIUP |ACT|REQ|SIH| |WWT| 1 |NWL| |AWT| DSTATE 






1 

2 


SYS I/O PROC NEXT DIT POINTER 
FIRST REQUEST IOQ POINTER 


3 


FLU|NCE|NPT| UNIT | LOGICAL DEVICE # 


U 


DLT POINTER 


5 


ILT POINTER 


6 


HGU|DSC|CFT|TTO|HTO| | SPE | SPW | RDT | ONL | DSY | LGO | BRK | ESC | BTO | STD 


7 


TIM|TMR|DELECHO|FFD| TTYPE |EXS|CNP| | PAIRCODE 


%10 


PEM| MTYPE |CF |CB | SB | NSY | RCT | WCT | PMD | TMODE | LPLEVEL 


11 


TPM|RES|SYN|ECH|SPS|ESC| | OUTSPEED |FIL|BOK| INSPEED 


12 


| | UNIT |PCL|PTY| NEXT DSTATE |PSL| 1 | 


13 


REQUESTED COUNT IN BYTES 


Ik 


READ/WRITE BYTE COUNT 


15 


WAITED STATE | HSTATE |TTW| TURN CHAR 


16 


SUB SYS BREAK CHAR | EOR CHAR 


17 


NEXT DITP OF BANDWIDTH WAITED DEVICE 


%20 


WRITE BYTES TANKED SO FAR / TIMEOUT LENGTH FOR BLOCK MODE READ 


21 


BYTE COUNT OF EOF SAVED READ 


22 


COUNT TO END OF READ/WRITE TBUF 


23 


HEAD POINTER TO READ/WRITE TBUF's 


2»»! 


TAIL POINTER TO READ/WRITE TBUF's 



DLINK 

DIOQP 

DLDEV 

DDLTP 

DILTP 

DRQST 

DTYPE 

DMODE 

DSPEE 

DCNTR 

| DRBC 

DBCNT 

DSAVE 

DSTOP 

DWAIT 

DXCNT 

DBTI 

DRCNT 

DCNT 

DHEAD 

DTAIL 
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23 

26 
27 
%30 
31 
32 
33 
3U 
35 
36 
37 

kl 



U2 
U3 



BYTE POINTER TO NEXT READ/WRITE BYTE 



HEAD POINTER TO EOF SAVED READ TBUF's 
TERMINAL TYPE |BWR|PTY SV| |NFM| DSPEED 



POINTER TO NEXT DIT IN TBUF WAIT LIST 
POINTER TO SAVED TBUF AFTER TBUF WAIT 





READ TIME/FIRST WORD OF 


DOUBLE TIMERS 




2ND WORD OF DOUBLE READ 


START TIMER READING 


MAXIMUM READ TIME IN SECONDS 


LF 


SYNCS | CR SYNCS 


| SYNC COUNT 


IOQP TO BROKEN READ SAVED DATE 




26U0/SPEED TRLX | 


LOGON/HANGUP/READ TRLX 




CFAIL TRLX I 


TURN TRLX 


LOGONTY|XOW|AEJ| CFAIL CUT 


| MCODE 




MMSTAT TIMING INFO 


|RQS| ESCSEQCNT 



DPNTR 

DRPTR 

DLAST 

DTBLK 

DNXTB 

DRTIM 
DRTI 

DRTMA 
DSYNC 
DBREA 
DTRLX 
DDSET 
DMONI 



DMMTI 



DMISC 
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TERMINAL DIT FIELDS AND DEFINITIONS 



DFLAG - FLAGS AND DEVICE STATE 



TERMINAL 
UP 

ACTIVE 

REQUEST 

SPECIH 

SPOOLING 

WRTWAIT 

PAIR 



NEWLINE 



PTYCHK/ 

26U5K 

FLAG 

TERMCHAR 



Device is a terminal 

If set, device is on line, has been speed sensed or 
has been initialized and can do I/O. If clear then 
in speed sense mode. 

If set, monitor is currently active servicing this 
device . 

Service for this device was requested while the 
monitor was active. 

Use special interrupt handler. 

Input has been requested through the PTAPE procedure. 

A character or sync is in the process of being output 
and a completion interrupt is expected. 

Pair is set whenever no read is in progress or when 
the action on the next character is dependent on the 
previous character input or the previous state. See 
paircode for details on the various pair conditions. 

A linefeed was the last character input or output. 
Used to determine if a CR/LF is necessary on mode 
changes or at FOPEN time. 

Read data is to be checked for correct parity, and if 
incorrect a parity error indication is to be returned to 
the caller. 

A special read termination character has been specified. 

The read data is to be checked and if the termination 

character is found the read will 

be terminated and the character set in the buffer. 

If the binaryread bit is set then this bit indicates a 

"transparent" read is in progress with sub system break 

and EOR characters in DSTOP. Both a termchar and a 

transparent read may be in progress simultanously if 

the termchar field of QPAR2 is not zero. 
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TERMINAL DIT (CONT.) 



BINARYREAD 



ACKWAIT 



DSTATE 



A biliary or transparent read was specified. If TERMCHAR 
is clear then a binary read is in progress. All 8 bits 
are transferred and no editing takes place. A binary 
read is teminated only when the count is satisfied. If 
termchar is set, then a transparent read is in progress. 
No editing takes place but only 7 bits are transferred. 
An EOR and sub system break character are held in DSTOP. 

An ENQ was sent to a 26U0/UU. Waiting for an ack or 
tine out before continuing the write. Has this meaning 
during write operations only. 

Device state. Specifies the current device activity 
and is used to detemine the next state. 

- null or no activity. 

1 - writing. 

2 - reading. 

3 - XON write, reading next. 

U - turning 202 modem to write state, next state in 
NXTD STATE. 

5 - wait for less terminal activity to start read/write 

6 - end of record (EOR) LF in progress, null state next. 

7 - EOR CR in progress, EOR CR state next. 
%10 - EOR sync in progress, EOR CR state next. 

%11 - write being waited for a break allowed check by 

term. 
%12 - delete LF or delete echo character being written 

or start read next. Send XON to start read next. 
%13 - delete CR being written, delete LF state next. 
%lU - "!!!" or syncs being written. Next state is delete 

CR or saved in WAITEDSTATE if sync set. 
%15 - 1st character of a termtype 11 read is being echoed. 
%l6 - have TIP start a read operation. 
%17 - finish up read then do DSTATE operation held in 

NXTDSTATE. 



DLIHK - Link word for linked list of the devices waiting for service 

-by the system 10 process. If not zero or -1 (end of list) 

then a DIT pointer to the next device waiting. 

DIOQP - SYSDB relative pointer to the first IOQ element in the request 
list for this device. 

DLDEV - Logical device number and unit number. 



FLUSH 



This flag is set whenever a break has been detected and 
accepted. While it is set, writes are returned completed 
without any I/O being done. Reads are returned with an 
unusual condition status, %173> 

It also holds off any further break service requests. 
It is reset with a function code 23 operation. 
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TERMINAL DIT (CONT. ) 

NO' CX" ECHO if set, then "!!!" is not to be echoed when a control 
X is detected to delete a line. 

.NO PTY Termtype is 8 bit in nature. (no pty set or check allowed) 

UNIT unit number of device. 

LDEVN Logical device number. 

DDLTP - SYSDB relative pointer to driver linkage table (DLT). 

DILTP - SYSDB relative pointer to interrupt linkage table (ILT). 

DRQST - Monitor service request flags. The requests are serviced in 

a left to right order. The bit position determines the 

priority with which the request is serviced. 

HANGUPTO Hangup timeout has been completed. 

DISCNCT Dataset has disconnected (dataset ready has dropped) . 

CFAILTO Timeout started when carrier failed has completed. If 
103 then hangup else try to turn 202 around again. 

TURNTO CB or SB is not true 5 seconds after starting the read 
to write turnaround on the 202. Hangup device. 

HP26U0T0 An ACKWAIT from an ENQ to 26U0/UU has timed out. The 
ACKWAIT is terminated and the write restarted. 

SP00LEND A control Y has been detected terminating PTAPE input. 

SP00LSW Switch PTAPE input buffers. 

READTO A read operation has been timed out. 

ONLINE A colon has been input and the device speed sensed. If 
not connected through a dataset, initiate a log on time 
out. 

DSETRDY Dataset ready has been detected. Initiate a log on 
time out. 

L0G0NT0 A log on time out has occurred. The caller has not 
logged on. The device is hungup. 

BRK A break has been detected or SB has dropped while writing. 
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TERMINAL DIT (CONT.) 

ESC A control Y has been detected. 

BLOCK TO Block mode read has timed out before completion. Read is 
returned with 10 timeout code. 

STAT DOME Logical write and associated status request have been 
completed for 2631B. 



DTYPE - Terminal type and other flags, 



TIMING 



TIMEREAD 



DELECHO 



FORMFEED 



TTYFE 



A request to measure the time taken to complete a read 
operation has occurred and the time at the initiation of 
the read has been saved in DRTIMED. When the read is 
completed, the time taken will be saved in DRTIME. 

The time required to complete a read operation is to be 
monitored and saved in DRTIME. 

This field contains a code which specifies the character 
to be output when a delete character (control H) is 
input. Different characters are output if the word 
count is zero to keep the carriage at the proper place. 



CODE 


1 
2 
3 



INPUToO INFUT=0 COMMENT 

nothing space terminal backspaces 

"/" nothing hard copy no backspace 

line feed space hard copy backspaces 

control T nothing 2600 control T backspaces 



If set then a form feed is output when the form feed 
character (%lU) is to be output. If clear a LF is 
output in place of the form feed character. In either 
case, the character is proceeded by an XOFF and carriage 
return. Usually clear for terminals which do not 
respond to a form feed. 



terminal type as specified 






- ASR 33 


9 


1 


- ASR 35 


10 


2 


- ASR 37 


11 


3 


- execuport 


12 


k 


- datapoint 


13 


r 


ftjt~_~.,~... 




2 


~ rnsrav»r«A 




6 


- terminet 


1U 



7 - 27H1 call 360 15 

8 - 27U1 PTTC/EBCDIC 16 



in the MFE ERS. 
mini bee (HP2615) 
HP26h0/Uh 

HP26U0/UU & auto enter cap 
HP26U5K Katakana/Roman data 
term connected to switching 
network or other cos n uter 
Multipoint terminal 
HP2635A print term (8 bit) 
HP2635A print term (7 bit) 
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TERMINAL DIT (CONT. ) 



ETXSENT End of Text (ETX) character has been sent to 
a 26U0X on a 202 to stop the terminal from 
listening. Carrier may now be dropped. 

CONSTRNTRPT. (11:1) If set then Control A on the Console will 
cause PROGEN to be awoken. If clear, then 
Control A is ignored. 
PAIRCODE when the action to be taken on the next character is 

dependant on the previous state or character input then 
this field contains a code specifying the previous 
character or condition. 

- no read in progress 

1 - XOFFPAIR. Last character input was an XOFF during 

a tapemode read on a terminet. EOR has been 
returned and if the next char is a CR then ignore 
it. 

2 - DELETEPAIR. A LF was echoed on a char delete. No 

LF echo is needed if next char is a control H. 

3 - ESCPAIR. Last character was an escape. Check next 

character for an escape sequence. 
*» - NODATAYET. A "NONSYNC" terminal read has been 
started with echo on but no data has been input 
yet. If the first character is a DC2 then paircode 
is set to enter (the DC2 is not saved) othewise 
process as a regular character. 

5 - NOECHO. A termtype 11 read has been started with 

echo off. If first char is a DC2 then set paircode 
to enter (1st char not saved) otherwise write 
character. 

6 - CRWAIT. A 26U0/UU block mode read has 

been satisfied and stopped and waiting for a CR to 
complete the read. No Control X checks are made to 
restart read. 

7 - CRWAITLF. Same as CRWAIT but an LF is to be echoed 

if requested after the CR is detected. 
Continue read with echo on. 

8 - ENTER. First character of a noecho read was a 

DC2. If next character not a CR then set Data Lost 
status, else set PRIMED and if Reading then restart 
read to input data. 

9 - DC2PAIR. Last character read was a DC2 from 

a 261+0/UU. If the next character is a CR then set 
primed, delete all data input and restart read. 
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TERMINAL DIT (CONT.) 



DMODEM - Modem state and control flags 



PREMPT 



MTYPE 



CF 
CB 



SB 
NOSYNC 



RDCOUNTED 



WRTCOUNTED 



PRIMED 



When set indicates that at least one request is 
preemptive. In this case a scan of the request list is 
made to determine which request should be processed 
first and if the current request is to be stopped. 



Modem Type 

- hardwired 

1 - 103 

U-7 -- Same as 



2 - 202S 

3 - 2002 

-3 except no speed sensing is done. 



Carrier detected status from dataset. 

Clear to send status from dataset. Request to send 

delayed. 

Secondary receive status. Senders CB when writing. 

If set specifies that no delays are used by this teminal. 
Instead an ENQ is sent after 80 characters and the write 
doesn't continue until an ACK is received or a timeout 
occurs. Set for 26U0/UU terminals. 

When set, indicates the "number of terminals doing block 
mode reads counter" has been incremented and when this 
operation completes the counter is to be decremented. 

When set, indicates that the "number of terminals doing 
writes" has been incremented and when this unit completes 
its operation the counter is to be decremented. 

When set indicates an "ESC D" sequence has been written 
or a DC2 has been received by a NOSYNC terminal. Before 
any read operation is initiated to a primed terminal to 

do a block mode read, the number of terminals doing I/O 
must be less than 13. If it is greater then a request to 
start the read is queued. 



TMODE 



LPLEVEL 



Terminal Mode. 

- normal 

1 - break mode 

2 - console mode 

3 - console mode and return to break mode 

Preempt level of last request. If preempt level of new 
request is higher then generate a CR/LF. 

- normal request 

1 - Not Used 

2 - normal request with terminal in console mode 

3 - soft prempt (preempt reads with no input yet) 
U - hard preempt (preempt all requests) 



n-"*7 



DSPEED - Multiplexor speed and other flags. 



TAPEMODE Input from paper tape. No characters are emitted in 
response to delete commands or at end of record. 

RESTART If set indicates that a write completion interrupt has 
occurred while the terminal buffers were being filled. 
The filling procedure restarts the write by issuing a 
SYNC. During a read if this bit is set, the read is to 
be restarted when a CR is detected because a control X 
deleting the line was detected. 
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TERMINAL DIT (CONT. ) 



SYNC 



ECHO 



If set and DSTATE=Repeating then SCOUNT contains the 
number of SYNC characters to be output after the 
completion of the current operation. If clear and DSTATE 
^Repeating, then SCOUNT contains the number of "!" 
remaining to be output in response to a Control X. 

If set specifies that characters read during input are 
to be echoed if the device is operating full duplex. 



SPDSENSING If set indicates that the device is in the speed sensing 
mode. When in the speed sensing mode a control has been 
sent to the multiplexor connecting the main channel to 
the diagnostic channels. 



ESC 



Control Y breaks have been enabled through an FCONTROL 
call. 



O UTSPEED A code used to determine the baud rate and character 
size of the data output. 

- 2U0 CPS or not determined k - 30 CPS 

1 - 2U0 characters per second (CPS) 5 - 15 CPS 

2 - 120 CPS 6-10 CPS 

3 - 60 CPS 7 - l 1 * CPS 

FILLING Set when IOTERHO is putting data into TBUFS. If the last 
TBUF is to be returned by TIP when this flag is set then 
the write is waited and DCNT is set to -2 by TIP to 
indicate TIP is waiting. 

BRKOK If set then break is allowed otherwise break is ignored. 
Set and cleared through FCONTROL calls. 

IKSFEED A code used to determine the baud rate and character 

size to be used to input data. The codes have the same 
meaning as those specified in outspeed above. 

DCNTRL - This is a control word output to the multiplexor board to 



PCL 



4 ttl^ut A A 



send control and data to the particular channel. It also 
contains other information in the unused areas. 

Parity Control bit. If set, parity is enabled. If 
it is zero, parity is disabled. 

This bit is 0RED into the eighth bit position on all 
characters output. If the eighth bit is zero it 
represents the parity of the character output if the 
parity control option is selected, otherwise it 
represents the sense of the eighth bit output. Also 
represents the parity expected during a read. Set when 
speed sensed or by function 21. 

HXTDSTATE This is the next DSTATE to be set after a 202 modem 

turnaround is completed. Also contains the next DSTATE 
after a FINISHREAD (DSTATE=%17) operation is completed. 
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TERMINAL DIT (COKT. ) 

PRESPLAST If set then the last write operation was a PRESPACE. 

If next write is a postspace and newline is not set then 
a CR/LF is output to clean up the carriage. 

DRBCT - For read and write request, this word holds the requested 
transfer count in bytes. 

DBCHT - During reads this word contains the number of characters input. 

During writes it contains the number of characters remaining 
to be written, including any already written from the current 
TBUF. 



DSAVE - Holds next DSTATE after waiting and repeating DSTATEs and 

also the next byte to be output after a 202 turnaround is 
completed. 

WAITEDS Holds the current DSTATE when a break is detected and 
an operation is suspended in order that terra may check 
that break is allowed. It also holds the next DSTATE 
after "STNC's" are output in the repeating DSTATE. 

HSTATE Hangup state. 

- null or hungup 

1 - on line or normal operating condition 

2 - log on time out in progress 

3 * 5 - INITWAIT. speed sense failed, disconnected speed 
U - DCLOSE issued, disconnect next. 

6 - hangup turn to read is in progress, the 202 dataset 

needed to be put in read state before hanging up. 

7 - hang up settling timeout is in progress. 

sensing delay, then reinitialize channel. 

TURNTOWRT If DSTATE is TURN202, then if set indicates a turn to 
write else the turn is a turn to read. 

TURNCHAR Holds the character to be output after the 202 is 
turned around from read to write. 

DSTOP - Holds the subsystem break and end of rocord characters if not 

zero indicating no editing is to be applied to a read. If 
not zero then no editing is to be applied to the characters 
input except for the following characters. 

BREAKCHAR Detection of this character causes the same action as 
the detection of control Y for a normal read. 



13-1*0 



TERMINAL DIT (COHT.) 



EORCHAR Detection of this character terminates input, if the 
device is in tapemode or 26UX doing block mode input, 
the read is not terminated until a CR is detected. 



DWAIT - Link word for a liked list of the devices waiting to be 

started when the terminal activity decreases. If not zero 
then a DIT pointer of the next device waiting. If -1 then 
signifies that this device is the last one in the list. 



DXCNT - Holds the number of bytes transferred so far to the TBUFs 



during a spacing or user's data transfer operation. Used to 
restart the TBUF fill operation after a wait because more 
than 270 bytes have already been tanked. (Valid for write.) 

DBTIME- Contains the timeout length for block mode read. (Valid for 

read. This is the same word of the DIT as DXCNT.) 



DRCNT - When read data has been saved because an EOF was returned 
this word contains the byte count of the saved data. 



DCNT - During a write, this word contains the number of characters 

remaining to be written from the current TBUF. During a read 
it contains the number of characters remianing to fill the 
current TBUF or to satisfy the read count. Set to -2 to 
indicate a write completed during a fill operation. When -1 
then new TBUF need to get next byte from. 

DHEAD - A S7SDB relative pointer to the current TBUF being written 
from or the first TBUF of a linked list during a read. 



DTAIL - A SYSDB relative pointer to the current TBUF being read 
into or the last TBUF of a linked list during a write. 



DOMTR - A SVCTIR «1«li™ Xir+o in/lav +/\ +Vtn 1 a •.+ V«+» tmiU»« — — 

urm m* m,m » mm m* * w*mrm* * ** •»*■» V « ▼ w mrj w9 4M*vk*a WW V«*^ AOS V mff Vw WA A V WW VA 

to last byte read. During a read if a new buffer is to be 

gotten to save the current byte input then this pointer is 
set to -1. 
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DRPTR - When not zero, this word points to a linked list of TBUFs 

which contain the data saved from a read which returned an 

EOF requesting the read to be saved. 



DLAST - Holds the default terminal type, parity save data and 
preconfigured speed code. 

TERMT Default terminal type. The terminal is set to this type 
when it is speed sensed. 
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TERMINAL DIT (CONT.) 



BWRITE If set the last write was in binary mode and PTYSAVE 
contains the original parity control and sense bits. 

PTYSAVE Holds the PTYCNTRL and parity bits during a binary write 
when parity generation is disabled and the parity sense 
is set to zero. 

HEWFORM Last carriage control was a form feed. 

DSPEED Preconfigured default speed code. See OUTSPEED 
for definition. 



DTBLK - Link word for a linked list of the devices waiting for a TBUF 

to be available. If not zero or -1 (end of list) then a DITP 

pointer of the next device waiting. 



DNXTB - Holds the pointer to a TBUF allocated to a device which has 
been waiting. Used to insure that a waiting device gets at 

least one TBUF when it comes to the top of the TBUF waiting 

list. 



DRTIME- During a times read, this is the reading of the timer at 

_ the initiation of the read. After a timed read is completed, 

the time in 1/100 of a second is saved in DRTIME as a 
single word. If it is -1 then the time was greater than 32K. 
DRTMAX- When a read operation time out is requested, this quantity 

represents the maximum time in seconds allowed for the read 

to be completed. 



DSYNC - CR and LF SYNC counts and the current SYNC count 



LFSYNC Contains the number of SYNCs to be issued after a carriage 
return is output. If >7, then actual count will be (N-6)*5 

CRSYNC Contains the number of SYNCs to be issued after a 

carriage return is output. If >7, then actual count will 
be (H-6)*5. 
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TERMINAL DIT (CONT.) 



SCOUNT SYNC COUNTER. Represents the number of SYNCs remaining 
to be issued after the current SYNC character is com- 
pleted. This field also holds the number of "!"'s re- 
maining to be echoed after a control X is input. 

NOTE - Holds 80 minus the number of characters written since the 
last read or ENQ for 26U0/UU terminals. When this count 
goes to zero, an ENQ is inserted in the write stream. 



DBREAK- On broken reads, this word holds a pointer to an IOQ 

element which contains the count, head, tail and DPNTR 

pointers used to restart the broken read. 

DTRLX - Holds read and data set time out request indexes. 



26U0TRLX holds the timer request index for 26U0/UU block mode 
reads and ENQ/ AGE time outs. 

READTRLX holds logon, hangup and read time out request indexes. 



DDSET - Holds the TRLX indexes for the timeouts associated with the 
data set control operations. 



CFAILTRLX Holds the TRLX index to time out loss of carrier detect 
TURNTRLX Holds the TRLX index to time out turn the 202 to write 
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DMONTR Hold monitoring control code. 

.LOGONTYPE- indicates type of logon type to this terminal 
0= :DATA 
1= :J0B 
2= : HELLO 
•XONWAIT - XOFT has been received during write, waiting for XON 
to continue. This hit is set when a write is paused 
hy a CONTROL S. 
.AUTOEJECT- 2631B will skip over perforations. 
.CFAILCNT - carrier fail detect count 
.MCODE - Monitor function and control code. 
•(13:5) - Function 

- Null or no monitoring 

1 - Call help 

2 - Monitor activity 

3 - Form Delta time histogram 

7 - Monitor calls/counts/initiations 
.(10:1) - Apply above to DSET1,DSET2 and DSETCONTROL 
.(11:1) - Apply above to TIP 
.(12:1) - Apply above to TERM 

DMMTIM - 2 words used for timing statistics 
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TERMINAL DIT (CONT. ) 

DMISC - miscellaneous bit fields: 



.REQSTAT - requesting 2631B status 

.ESCSEQCNT- index into excape sequence for 2631B and VIEW 



During PTAPE reads, several of the DITP words are used for different 
purposes than those in a normal read. The words and their use are 
listed below. 



DBCNT - A 16 bit logical quantity representing the total number of 
characters input during this PTAPE read. 



DCNT - SYSDB relative pointer to the base of the SBUF currently 
being used to hold the data as it is input. 



DHEAD - SYSDB relative pointer to the base of the SBUF to be written 

to virtual, memory or the pointer to the buffer to be used 

when the current one is full. 
DTAIL/ 
DPNTR- Double word logical disc address to the area where the next 

SBUF is to be written in virtual memory when it is full or 

the PTAPE read is terminated. 
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TERMINAL DIT (COMT.) 

TERMINAL SPEED ENCODING 

The default speed code set in the DIT will be used to initialize 
both the input and output speeds . This parameter will be used 
to determine the speed when an FCONTROL 37 (Allocate Terminal) is 
issued which does not specify a speed. 

CODE (Future rel) 



1 
2 

3 
U 

5 
6 

7 
6 

9 
10 
11 

13 
Ik 
15-63 Reserved for future expansion 

The default speed code will be set in word %27 bits 10 thru 15 of the 
terminal DIT. 



I I 

|0 1 2 3 U 5 6 7 8 9 10 11 12 13 1A 151 

%27 I Terminal Type |BWT|PTYSV|///|NFM| DEFAULT SPEED| 23 DLAST 



SPEED (Baud) CODE (SER: 


Undefined 





Externally Clocked 

50 

75 

110 

13U.5 

150 

200 


6 
7 

5 


300 
600 


3 


1200 

Woo 


2 

1 


7200 
9600 
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CARD READER DIT 

1 2 3 ' U 5 6 7 8 9 10 11 12 15 
|..|..|...|„.|__.| 1„|.„.|.„|„„|.„,„.| 

I 0| 0|ACT|REQ| I I I I/0| IAK|READ| NR| j HSTATE 

I I I I I I I |PROG| |DONE|HSG| 

I - — 

1| DITP LINK TO NEXT DIT 

I- 

2 1 IOQP POINTER TO 1st REQUEST 

I - 

31 .. UNIT # I LOGICAL DEVICE # 

I 

U| DRIVER LINKAGE TABLE POINTER 

I 

51 INTERRUPT LINKAGE TABLE POINTER 

I- — - 

6| (SEE BELOW) 

I - 

71 ERROR STATUS IF NOT 

I - 

%10| REQUESTED WORD COUNT 

I— - 

DSTAT bits: 



DFLAG 

DLINK 
DIOQP 
DLDEV 
DDLTP 
DILTP 
DSTAT 
DSERR 
DWCNT 



BIT0=SIO OK 
BIT1=0 

BIT2=INT PENDING 
BIT3=TIMING ERROR 
BITU-LIGRT DARK CHECK 
BITS 5-6 = 00 COLUMN BINARY MODE 
01 UNUSED 

10 PACKED BINARY MODE 

11 HOLLERITH-TO-ASCII MODE 
BIT7=COMPARE ERROR 

BIT8=EOF DETECTED 

BITS 9-10 - 00 NORMAL 

01 HOPPER EMPTY 

10 UNUSED 

11 STACKER FULL 
BIT11=INVALID HOLLERITH 
BIT12=PICK FAIL OR MOTOR CHECK 
BIT13=TEST 

BITlU=TROUBLE 
BIT15=NOT READY 
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CARD READER DIT FIELD DEFINITIONS 
DFLAG - Flags and device state 

ACTIVE Monitor is currently active servicing this device. 

REQUEST Service for this device was requested while the monitor 
was active. 

IOPROG SIO program in progress. 

IAK Interrupt occurred or request aborted or preempted. 

READDONE Previous read resulted in an EOF with a backup save 
• requested. The data has been saved in an auxiliary 
buffer and will be passed back on the next read request. 

NRMESSAQE Set when a not ready message has been issued, and cleared 
when the reader is found ready. Used to prevent multiple 
Not Ready messages when power is turned on. 

MSTATE Monitor State. See SIODM specifications for details. 

DUNK - S7SDB relative ponter to the DIT for the next device 
requesting service for this resource. 



DIOQP - S7SDB relative pointer to the first IOQ element in the request 
list for this device. 



DLDEV - Logical device number and unit number. 

UNIT Unit number of device. 
LDEVN Logical device number. 

DDLTP - S7SDB relative pointer to driver linkage table (DLT) . 

DILTP - SYSDB relative pointer to interrupt linkage table (ILT). 

DSTAT - Device interrupt status. Contains the device interrupt status 
at the last interrupt. See hardware ERS for details. 

DSERR - Device interrupt error status. If not zero, then holds the 
device interrupt status from an operation with an erroneous 
completion status. Causes SIODM to log an error. 

DWCNT - Holds the requested transfer count in words. 
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Device Information Table for HPIB Card Reader 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element. The following diagram shows the DIT used for 
the card reader driver. 

1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 MNEMONIC 

+ — +--+--+ — +--+ — + — + — +--+--+ — + — +--+ — + — +--+ 
0| 0| 0|AC|RQ| 0|MU| 0|I0|IA|N0|ST| 0| STATE | DFLAG 

+--+ — + — +--+ — +--+ — +--+--+--+--+--+ + 

1| SYSDB relative pointer to the DIT for the next| DLINK 

| device requesting this resource or service j 

+— — — + 

2 | SYSDB relative pointer to the first IOQ in | DIOQP 

| request list for this device j 

+-■ ' -+ + + 

31 IOT | Phys. unit # | Logical device number | DLDEV 

+ +-- + + 

1*1 SYSDB relative pointer to Device Linkage Table | DDLTP 

+ + 

51 SYSDB relative pntr to Interrupt Linkage Table | DILTP 

+ + 

6| | DRQST 

+ + 

71 Hardware error status. Set when the driver | DSERR 

| detects an error. Whenever <>0, the driver j 

| monitor logs an I/O error and clears this word| 

+--+ — + — + — + — + + 

*10|RD|NM| | DSAVE 

+— + — +--+--+ — + + 

%11| Request word count | DWCNT 

+ ~ + 

%12| Interrupt Status for this unit. Set by the | DLOGERROR 
i driver each time it processes an interrupt. j 
+ + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

MU MUNIT 

10 I0FR0G 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
active. 

- This device is on a multi-unit controller. 

- An I/O Channel Program is running for this device. 

- An interrupt or response has occurred for this device. 

- Go to state %10 after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to "be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completer procedure 
k - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

JfclO - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - Device logical device number 
IOT I/O TYPE - I/O System type 

= Series II / III I/O system 

1 = HP-IB 

2 = unused 

3 = unused 

DSAVE - Device processing flags 

RD READDONE - A card has already been read. 

NM HRMESSAGE - Indicates if not ready message has been issued to 
the operator's console. 
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ADCC DIT /30,/33,A«4 



1 2 3 k 5 6 7 8 9 10 11 12 13 1U 15 



0|TM|UP|AC|RQ|SH|SP|MA|PR|NL|PC|TC|BR| DSTATE 

1| SYSIO PROCESS NEXT DIT POINTER 

2 J FIRST REQUEST ICQ POINTER 

3|FL|NE|RF| | LOGICAL DEVICE # 

M DLT POINTER 

51 ILT POINTER 

6|HU|DC|CF|TT|TO|AW|SW|SE|RT|OL|DR|LO|BK|SK|BT|SD 
7rTM|TR|DLECH|FF| TTYPE |WX|CI| PAIRCODE 
%10|PM| MTYPE |CF|CB|SB|NS|RC|WD|PR|TMODE|LP LEVEL 
ll|TM|RS|EO|EC|SS|SB| OUTSPEED |RT|BO| INSPEED 

12|HW|LL|SS|DONXTMOD|DM|PO|OP|NEXTDSTATE |PS|FL|AE 

131 REQUESTED BYTE COUNT 

l^lRD CHAR ALREADY INPUT/CHARS LEFT TO WRITE 

15lWAITEDSTATE| HSTATE |TW|DA|CC|BC|PE| |SR|lI|CO 

16| SUBSYS BREAK CHAR | EOR CHAR 

171 DITP OF NEXT DEV WAITING FOR BANDWIDTH 

%20| WRITE BYTES TRANSFERRED SO FAR 
21 j BYTE COUNT OF EOF SAVED DATA 
22 j READ/WRITE COUNT TO END OF CURRENT TBUF 
231 HEAD POINTER TO READ/WRITE TBUFS 
2»»| TAIL POINTER TO READ/WRITE TBUFS 
251 BYTE OFFSET IN TBUF TO START CHANNEL PROGRAM 
26| HEAD POINTER TO EOF SAVED READ TBUFS 
271 TERM TYPE |BW|EB|NF| DEFAULT SPEED 

%30| POINTER TO NEXT DIT IN TBUF WAIT LIST 





1 DLINK 

2 DIOQP 

3 DLDEV 
U DDLTP 

5 DILTP 

6 DRQST 

7 DTYPE 

8 DMODEM 

9 DSPEED 

10 DCNTRL 

11 DRBCT 

12 DBCNT 

13 DSAVE 
1*1 DSTOP 

15 DWAIT 

16 DXCNT/DBTIME 

17 DRCNT 

18 DCNT 

19 DHEAD 

20 DTAIL 

21 DPNTR 

22 DRPTR 

23 DLAST 
2U DTBL 
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31 
32 
33 
3U 
35 
36 
37 
%ko 
1*1 
U2 
U3 



POINTER TO SAVED TBUF AFTER TBUF WAIT j 25 DNXTB 

- "I 

TOTAL READ TIME / 1ST WORD OF TIMER READING 1 26 DRTIME/DRTIMED 

" 1 

2ND WORD OF TIMER READING j 27 

" 1 

MAX READ TIME IN SECONDS j 28 DRTMAX 

— - I 

LF SYNC I CR SYNC | SYNC COUNT 1 29 DSYNC 

I 

IOQP TO INFO ON SAVED BROKEN READ DATA | 30 DBREAK 

"-- " I 

26U0 TRLX I LGON/HNGUP/RDTIMR TRLX |31 DTRLX 

" I 

CFAIL TRLX | TURN TRLX j 32 

I 

NUMBER OF BYTES IN OUTSTANDING TANKS j 33 

LGNTY|SYNST| CFAIL COUNT | LF COUNT |3U DMONTR 

" - " ""I 

POINTER TO BEGINNING OF SIO PROGRAM j 35 DSIOPC 

" I 

POINTER TO SECOND TBUF USED FOR READ 1 36 DBLKTAIL 

I 
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DIT INFORMATION 



DFLAG 
.TERM (0:1) - SET IF DEVICE IS A TERMINAL 

.UP (1:1) - SET IF DEVICE IS ON LINE AND HAS BEEN SPEED SENSED, 
OR HAS BEEN INITIALIZED (BY ALLOCATING TERMINAL) 
AND READY TO DO 10 
.ACTIVE (2:1)- SET IF IOTERMO IS CURRENTLY ACTIVE SERVICING THIS 

TERMINAL 
.REQUEST (3:1)- SET IF SERVICE FOR THIS TERMINAL IS REQUESTED 

WHILE IOTERMO IS ACTIVE 
.SPECIH (l»:l) - SET IF SPECIAL INTERUPT HANDLER IS USED, NOT 

APPLICABLE 
.SPOOLING (5:1) - A READ OERATION TO USE SYSBUF HAS BEEN REQUESTED 

THROUGH THE PTAPE PROCEDURE 
.MODACTIVE (6:1) - SET IF SIO PROGRAM TO CONTROL MODEMS IS 

CURRENTLY ACTIVE 
.PAIR (7:1) - SET (1) WHEN NO READ IS IN PROGRESS, OR (2) DURING 
READING, THE NEXT CHARACTER INPUT MAY REQUIRE SOME 
SPECIAL ACTION, SEE PAIRCODE FOR DETAILS 
.NEWLINE (8:1) - SET IF THE LAST CHARACTER OUTPUT IS A LF, USED 
TO DETERMINE IF A CR/LF IS NECESSARY DURING 
MODE CHANGES OR AT FOPEN TIME 
.PTYCHK (9:1) - SET IF PARITY CHECKING/GENERATION IS ENABLED, ODD/ 

EVEN PARITY IS DETERMINED BY ODDPTY IN DCNTRL 
.TERMCHAR (10:1) - SEE BINREAD 
.BINREAD (11:1) — 

TERMCHAR BINREAD 



REGULAR READ 

1 BINARY READ IN PROGRESS, THE READ 

IS ONLY TERMINATED WHEN THE 
REQUESTED BYTE COUNT IS SATISFIED 

1 SPECIAL EOR CHARACTER IS SPECIFIED 

IN QP2 TO TERMINATE READ 
1 1 TRANSPARENT READ IN PROGRESS, NO 

EDITING IS PERFORMED ON INPUT DATA, 
READ IS TERMINATED BY EOR CHARACTER 
SPECIFIED IN DSTOP OR QP2 OR SUBSYS 
BREAK CHARACTER IN DSTOP 

.ENQACKWAIT (11:1) - DURING WRITE, BIT 11 IS SET WHEN THE CURRENT 

CHANNEL PROGRAM SUSPENDS THE WRITE BY SENDING 
AN ENQ AND THEN WAITS FOR AN ACK FROM THE 
TERMINAL 
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.DSTATE(12:U) - DEVICE STATE OF THE TERMINAL, SPECIFIES THE 

CURRENT ACTIVITY AND DETERMINES THE NEXT STATE 

1 - WRITING 

2 - READING 

U - TURN202; CURRENTLY TURNING AROUND THE 202 MODEM TO DO 
READ OR WRITE, NEXT DSTATE IS IN DCNTRL . NXTDSTATE 

6 - EORLF; END OF RECORD CARRIAGE CONTROL IN PROGRESS, NULL 

STATE NEXT 

7 - SPDSENSW -- SPEED SENSE SIO IN PROGRESS 
£L0 - EORSYNC 

%11 - WAITED; READ OR WRITE OPERATION BEING SUSPENDED, WAITING 
FOR IOTERMO TO CHECK IF BREAK IS ALL OWED 

%lU - REPEATING; "!!!" BEING WRITTEN AFTER CONTROL X IS 
DETECTED , EORLF NEXT TO OUTPUT CR/LF 

%16 - MODEMSIO; CHANNEL PROGRAM CURRENTLY ACTIVE IN SETTING UP 
THE ADCC MODEM CONTROL LOGIC. WHEN THE CHANNEL PROGRAM 
COMPLETES, IF DCNTRL. DOMOD IS SET, A NEW CHANNEL PROGRAM 
IS STARTED TO SET THE MODEM LOGIC TO A NEW SET OF 
CONDITIONS. THE NEXT DSTATE IS IN NXTDSTATE. 

JtL7 - FINREAD; FINISH UP READ OPERATION AND PERFORM THE DSTATE 
INDICATEDIN NXTDSTATE. 

1 - DLINK 

LINK WORD FOR A LINKED LIST OF DEVICES WAITING FOR SERVICE BY THE 

SYSTEM I/O PROCESS. 

=> NONE WAITING 

-1 => LAST DEVICE ON LINKED LIST 

DITP -- A POINTER TO THE DIT OF THE NEXT WAITING DEVICE 

2 - DIOQP 

SYSDB RELATIVE POINTER TO THE 1ST IOQ ELEMENT IN THE SERVICE 
REQUEST LIST FOR THIS DEVICE 

3 - DLDEV 

.FLUSH (0:1) - SET WHEN A BREAK HAS BEEN DETECTED AND ACCEPTED. 
AS LONG AS IT REMAINS SET, ALL WRITE REQUESTS ARE 
RETURNED AS COMPLETED WITHOUT ANY ACTUAL I/O 
BEING PERFORMED. READS ARE RETURNED WITH AN 
UNUSUAL CONDITION STATUS, %173- 

.NOCXECHO (1:1) - IF SET, THEN "111" IS NOT ECHOED WHEN A CONTROL 
X TO DELETE A LINE HAS BEEN DETECTED 

.RDFLUSH (2:1) - NO TBUFS; FLUSH READ, WAIT FOR EOR 

.LDEVN (8:8) - LOGICAL DEVICE NUMBER 

.ABORWRT (5:1) - WRITE SIO HAS BEEN ABORTED 

4 - DDLTP 

ji.,~ •*«•• inTTin nnTtmm m/% mm IMSTTTSTl T TMTTA/W "PAnT.? 1 fTO.Tl 

SlSDS nCiliAlXVC rulfllDn iU inn uniTan uxnunuu """™ x*'— / 

5 - DILTP 

SYSDB RELATIVE POINTER TO INTERRUPT LINKAGE TABLE (ILT) 
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.DISCHCT (1:1) 
.CFAILTO (2:1) 

.TURNTO (3:1) 



,26U0TO (U:l) 



DRQST 

REQUESTS FOR IOTERMO SERVICE THAT HAVE BEEN GENERATED BY TIP. 

THE REQUE STS A RE SERVICED IN A LEFT TO RIGHT ORDER, SO THE BIT 

POSITION DETERMINES THE REQUEST PRIORITY. 

•HANGUP (0:1) - DATASET HANGUP TIMEOUT HAS BEEN COMPLETED 

DATASET HAS BEEN DISCONNECTED (CC HAS DROPPED) 
TIMEOUT FOR CARRIER FAIL HAS BEEN COMPLETED, 
HANGUP A 103 MODEM OR TRY TO TURNAROUND A 202. 
CB OR SB FROM THE 202 MODEM DID NOT RISE 5 SECONDS 
AFTER STARTING THE "READ TO WRITE TURNAROUND", 
HANG UP THE DATASET. 

A 10 SECOND TIMEOUT TO WAIT FOR AN ACK FROM THE 
TERMINAL HAS EXPIRED, TERMINATE THE WAIT AND 
RESTART THE WRITE OPERATION 

.SPOOLSW (6:1) - ONE OF THE TWO SYSBUFS USED FOR PTAPE READ HAS 

BEEN FILLED, SWITCH THEM SO THAT IT CAN BE EMPTIED 
ONTO DISC. 

.SPOOLEND (7:1) - A CONTROL Y TO TERMINATE PTAPE READHAS BEEN 
DETECTED 

.READTO (8:1) - A READ OPERATION HAS BEEN TIMED OUT 

ALSO SPFOUND, A CR HAS BEEN INPUT AND SPEED 
SENSED, INITIATE A LOG ON TIMEOUT 

- DATASET READY (CC) HAS BEEN DETECTED, INITIATE 
A LOGON TIMEOUT 

- A LOGON TIMEOUT HAS EXPIRED AND THE CALLER STILL 
HAS NOT LOGGED ON; HANGUP THE DEVICE 

BREAK HAS BEEN DETECTED, OR SB FROM THE DATASET HAS 
DROPPED DURING A WRITE OPERATION 

.SSBRK (13:1) - A SUBSYSTEM BREAK HAS BEEN DETECTED 

.BLOCKTO (1U:1) - BLOCK MODE READ HAS TIMED OUT 

.STATDONE (15:1) - 

DTYPE 

SET IF THE TIME REQUIRED TO DOMPLETE THE CURRENT 
READ OPERATION IS TO BE RECORDED, THE STARTING 
TIME HAS BEEN RECORDED IN DRTIME, WHEN THE READ 
IS COMPLETED, THE ELAPSED TIME WILL BE SAVED IN 
DRTIME 

- SET WHEN THERE IS A REQUEST TO MEASURE THE TIME 
REQUIRED TO COMPLETE A READ OPERATION, CAUSES 
TIMING TO GET SET WHEN THE READ IS INITIATED. 

THIS FIELD CONTAINS A CODE WHICH SPECIFIES THE 

REQUIRED ACTION WHEN A CONTROL H IS DETECTED 

.FORMFEED (U:l) - SET FOR TERMINALS THAT RESPOND TO A FORMFEED, IF 
CLEAR, A LF IS SENT IN PLACE OF THE FF CHARACTER; 
THE CHARACTER TO BE OUTPUT (FF OR LF) IS PRECEDED 
BY A XOFF AND CR. 
.TTYPE (5:5) - TERMINAL TYPE, A SUBSET OF THE SERIES III TERM TYPES 
.WAITXON (10:1) - WAITING FOR XON 

.CONSINTRPT (11:1) - SET IF CONTROL A CAN BE ACKNOWLEGED WHEN THE 

TERMINAL IS USED AS A SYSTEM CONSOLE 



.ONLINE (9:1) 
.DSETRDY (10:1) 
.LOGONTO (11:1) 
.BRK (12:1) - A 



.TIMING (0:1) 



.TIMEREAD (1:1) 



.DELECHO (2:2) 
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.PAIRCODE (12 :U) - WHEN THE NEXT INCOMING CHARACTER MAY REQUIRE 

SPECIAL ACTION, THIS FIELD CONTAINS A SPECIAL 
CODE SPECIFYING THE CONDITIONS AND ACTIONS TO 
BE TAKEN: 

- NO READ IN PROGRESS 

1 - CRWAIT; A BLOCK MODE READ HAS BEEN SATISFIED AND STOPPED, 

NOW WAITING FOR A CR TO COMPLETE THE READ 

2 - CRWAITLF; SAME AS CRWAIT BUT AFTRE THE CR IS DETECTED, A 

LF IS TO BE ECHOED IF REQUESTED 

3 - NOECHO; A TERMTYPE 11 READ HAS BEEN STARTED WITH ECHO OFF, 

IF THE FIRST INCOMING CHARACTER IS A DC2, THEN A BLO CK 
MODE READ IS ABOUT TO BEGIN, OTHERWISE THE CHARACTER IS TO 
BE ECHOED BACK TO THE TERMINAL AND ECHO TO BE TURNED BACK 
ON. 

k - DC2PAIR; THE LAST CHARACTER READ WAS A DC2, IF THE NEXT 
CHARACTER IS A CR AND IF OWN DC1/DC2 HANDSHAKE IS ENABLED, 
THE READ OPERATION WILL BE COMPLETE; IF THE NEXT CHARACTER 
IS A CR AND OWN DC1/DC2 HANDSHAKE DISABLED, THEN THE CR 
IS IGNORED AND READ WILL CONTINUE. 

5 - NODATAYET; A REGULAR READ HAS BEEN STARTED WITH ECHO ON. 

£ - DMODEM 

.PREMPT (0:1) - WHEN SET BY ATTACHIO, AT LEAST ONE PENDING REQUEST 

IS PREEMPTIVE 
.MTYPE (1:3) - MODEM TYPE: 

- HARDWIRED TERMINAL 

1 - 103 MODEM 

2 - 202C MODEM 

3 - 2002 MODEM 

U-7 -> SAME AS 0-3, BUT NO SPEED SENSING 
(6&7 NOT CURRENTLY SUPPORTED) 
.CF (U:l) - CURRENT CARRIER DETECT STATUS FROM MODEM 
.CB (5:1) - CURRENT CLEAR TO SEND STATUS FROM MODEM 
,.SB (6:1) - CURRENT SECONDARY RECEIVE STATUS FROM MODEM 
.NOSYNC (7:1) - SET FOR HP263X, HP26UX TERMINALS; INDICATES THAT 
NO DELAYS BETWEEN CHARACTERS ARE NECESS ARY F OR 
THIS TERMINAL, INSTEAD, AN ENQ IS SENT AFTER EVERY 
80 CHARACTERS AND THE WRITE OPERATION IS SUSPENDED 
UNTIL AN ACK IS RECEIVED OR A 10 SECOND TIMEOUT 
OCCURS. 
.PRIMED (10:1) - INDICATES THAT A DC2 HAS BEEN RECEIVED FROM THE 

TERMINAL DOING A FAST READ. A BLOCK MODE READ IS 
IN PROGRESS. 
.TMODE (11:2) - TERMINAL MODE: 

- NORMAL 

1 - BREAK MODE 

2 - CONSOLE MODE 

3 - CONSOLE MODE AND RETURN TO BREAK MODE 
.LPLEVEL (13:3) - PREEMPT LEVEL OF LAST REQUEST, IF PREEMPT LEVEL 

OF THE NEW REQUEST IS HIGHER, CR/LF IS TO BE OUTPUT 
TO THE TERMINAL: 
- NORMAL REQUEST 

2 - NORMAL REQUEST WITH TERMINAL IN CONSOLE MODE 

3 - SOFT PREEMPT (PREEMPT READ OPERATION THAT 

HAS NOT INPUT ANY DATA YET) 
U - HARD PREEMPT (PREEPMT ALL READS) 
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9 



DSPEED 
.TAPEMODE 



(0:1) 
•RESTART (1:1) 



.ECHOON (2:1) 
•ECHO (3:1) - 
.SPDSENSING 



- CURRENT INPUT IS FROM PAPER TAPE, INCOMING 

CHARACTERS ARE TRANSPARENT 
■ WHEN THE TERMINAL IS IN TAPEMODE OR BLOCK MODE 
READ AND A CONTROL X HAS BEEN DETECTED, PAIRCODE 
IS SET TO CRWAIT TO WAIT FOR A CR T TERMINATE THE 
READ, AT WHICH TIME THE READ IS TO BE RESTARTED 
ECHO WAS TURNED OFF, REENABLE IT FOR CURRENT 
OPERATION 
- IF SET, ALL INCOMING CHARACTERS ARE TO BE ECHOED IF 

OPERATING IF FULL DUPLEX MODE 
(U:l) - SET IF CURRENTLY IN SPEED SENSE MODE, THE 
FIRST PORTION OF A POSSIBLE CR HAS BEEN 
IDENTIFIED AND WAITING TO RECEIVE THE REST OF 
THE CHARACTER. 
SSBRKOK (5:1) - SUBSYSTEM BREAKS HAVE BEEN ENABLED VIA A FCONTROL 
CALL. 
CONTAINS AN ADCC CODE FOR THE CURRENT OUTPUT 
BAUDRATE; ADCC CODES FOR DIFFERENT BAUDRATES- 
% 7 - 2U0 CPS 
%10 - 960 CPS 

- Il80 CPS 

- 120 CPS 

- 30 CPS 

- 15 CPS 

- 10 CPS 

RESTART IDLE WAIT OR SPEEDSENSE AFTER 
CURRENT CHANNEL PROGRAM COMPLETES. 

HREAK IS ALLOWED IF SET, OTHERWISE IGNORED. SET 
^^ AND CLEARED VIA FCONTROL CALLS. 
INSPEED (12 :U) - CANTAINS AN ADCC CODE FOR THE CURRENT INPUT BAUDRATE 



.OUTSPEED (6:U) 



»1 
%13 
%15 
3U6 

%17 
.RESTARTSPDS (10:1) - 



.BRKOK (11:1) 



10 



DCNTRL 
.HIOPWAIT 



•LFLAST (1:1) 
.SPDSIO (2:1) 



(0:1) - THE ACTIVE CHANNEL PROGRAM CANNOT BE HALTED 
IMMEDIATELY WHEN AN HIOP INSTRUCTION WAS 
EXECUTED; A SUBSEQUENT INTERRUPT WILL OCCUR AND 
SOFTWARE IS TO IGNORE IT. 
A POSTSPACE LF HAS BEEN TANKED INTHE WRITE TBUF'S 
SET WHEN AN IDLE WAIT CHANNEL PROGRAM IS ACTIVE 
WHEN THE TERMINAL IS NOT ACTIVE DOING READ/WRITE, 
AN IDLE WAIT PROGRAM IS STARTED TO LISTEN TO 
THE KEYBOARD. 
.DONXTMOD (3:3) - AN ATTEMPT TO START A CHANNEL PROGRAM TO CONTROL 
THE ADCC MODEM LINES FAILED BECAUSE A PREVIOIUS 
MODEM CONTROL PROGRAM IS STILL ACTIVE. THIS 
FIELD CONTAINS A CODE SPECIFYING THE CONTROL TO 
BE DONE WHEN THE PREVIOUS CHANNEL PROGRAM 
COMPLETES AND THE NEW ONE CAN BE STARTED 
ATTEMPT TO START A MODEM CONTROL CHANNEL PROGRAM 
FAILED BECAUSE A PREVIOUS ONE IS STILL ACTIVE- 
WHEN IT COMPLETES, START THE MODEM CONTROL CHANNEL 
PROGRAM AS SPECIFIED IN DONXTMOD 



.DOMOD (6:1) 
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.PTYON (7:1) - SPECIFIES PARITY GENERATION ON WRITE DATA AND 

PARITY CHECKING ON READ DATA 
.ODDPTY (8:1) - IF SET, ODD PARITY IS USED FOR GENERATION AND 

CHECKING, OTHERWISE EVEN PARITY IS USED. 
.NXTDSTATE (9:U) - CONTAINS THE NEXT DSTATE TO BE USED WHEN A 202 

MODEM TURNAROUND IS COMPLETED, ALSO CONTAINS 
THE NEXT DSTATE WHEN A FINISHREAD (DSTATE=%17) 
OPERATION IS COMPLETED. 
•PRESPLAST (13:1) - INDICATES THAT THE LAST WRITE OPERATION WAS A 

PRESPACE WRITE, IF THE NEXT WRITE IS POSTSPACE 
AND NEWLINE IS NOT SET THEN A CR/LF IS OUTPUT 
TO START WRITING A NEW LINE. 
.FILLING (lU:l) - INDICATES THAT IOTERMO IS CURRENTLY TRANSFERRING 

WRITE DATA FROM THE CALLER'S STACK INTO A TBUF. 
.ADDENQ (15:1) - IOTERMO IS CURRENTLY PUTTING AN ENQ INTO THE TBUF 
AFTER 80 BYTES OF WRITE DATA HAVE BEEN TANKED. 

11 - DRBCT 

HOLDS THE REQUESTED READ/WRITE BYTE COUNT 

12 - DBCNT 

DURING A READ OPERATION, IT SPECIFIES THE NUMBER OF BYTES THAT 
HAVE BEEN READ. DURING A WRITE OPERATION, IT SPECIFIES THE 
NUMBER OF BYTES REMAINING TO BE WRITTEN. 

13 - DSAVE 

.WAITEDSTATE (0:U) - HOLDS THE CURRENT DSTATE WHEN A BREAK IS 

DETECTED AND THE CURRENT OPERATION SUSPENDED 
SO THAT IOTERMO MAY CHECK THAT BREAK IS ALLOW- 
ED, IF DISALLOWED, THE CURRENT DSTATE WILL BE 
RESUMED. 

.HSTATE (U:3) - THE MODEM HANGUP STATE: 

- NULL OR HUNGUP 

1 - ON LINE OR NORMAL OPERATION 

2 - LOGGINGON; LOG ON TIMEOUT IN PROGRESS 
k - DCLOSE ISSUED, DISCONNECT NEXT 

6 - HANGUPTURN; HANGUP TURNAROUND TO READ IN 

PROGRESS, THE 202 MODEM NEEDS TO BE IN A READING 
STATE BEFORE HANGUP 

7 - HANGUP SETTLING TIMEOUT IN PROGRESS 
.TURNTOWRT (7:1) - WHEN THE 202 MODEM IS BEING TURNAROUND (DSTATE= 

TURN202), A 1 INDICATES TURNAROUND TO WRITE, A 

INDICATES TURNAROUND TO READ. 

.DELACK (8:1) - AN ENQ HAS JUST BEEN SENT DURING A WRITE WHEN A 

BREAK WAS DETECTED, DELAY THE NEXT WRITE FOR 
n c c«?rv\im mn AtxnTn rwrenmrmiTVin rrm •pfpmtiiat 

.CC (9:1) - THE CURRENT DATASET READY STATUS FROM MODEM 

•BLOCKRD (10:1) - DURING A READ OPERATION, 2 CHANNEL PROGRAMS, 
EACH WITH ITS OWN TBUF, ARE USED TO SERVICE 
INCOMING DATA; THIS BIT IS SET IF THE 2ND 
CHANNEL PROGRAM IS CURRENTLY ACTIVE RECEIVING 
DATA. 

.AUTOEJECT (11:1) - 2631B WILL SKIP OVER PERFORATIONS 

.REQSTAT (13:1) - REQUESTING 2631B STATUS 

.ININ (lU:l) - INITIALIZING TERMINAL PORT 

.CCON (15:1) - CC ALWAYS ON 
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lU - DSTOP 

IF MOT ZERO, CONTAINS THE USER SPECIFIED SUBSYSTEM BREAK AND 

END OF RECORD CHARACTERS. IF THEY ARE SPECIFIED, THEN NO EDITING 

IS DONE TO THE INCOMING DATA DURING A READ. 

.BRKCHAR (0:8) - DETECTION OF THIS CHARACTER DURING READING CAUSES 
THE SAME ACTION AS THAT OF A CONTROL Y. 

.EORCHAR (8:8) - DETECTION OF THIS CHARACTER TERMINATES THE READ 

AND IS INCLUDED WITH THE REST OF THE READ DATA TO 
BE TRANSFERED TO THE CALLERS STACK 

15 - DWAIT 

LINK WORD FOR A LINKED LIST OF DIT'S WAITING TO DO I/O WHEN THE 

TERMINAL ACTIVITY DECREASES, 

- NONE WAITING 

-1 - THIS DIT IS THE LAST ONE ON THE LIST 

OTHER - A DIT POINTER TO THE NEXT DEVICE WAITING 

16 - DXCNT (WRITE )/DBTIME (READ) 

DXCNT (VALID DURING WRITES) INDICATES THE NUMBER OF BYTES TRANSFERRED 

SO FAR INTO TBUF'S WHEN CARRIAGE CONTROL BYTES OR DATA BYTES ARE 

BEIN G TANKED. USED TO RESTART THE FILL TBUF OPERATION WHEN 5U0 

BYTES HAVE ALREADY BEEN TANKED AND THE FILL OPERATION HAS TO BE 

SUSPENDED. 

DBTIME (VALID DURING READ) - TIMEOUT PERIOD FOR BLOCKMODE READ. 

17 - DRCNT 

CONT AINS THE BYTE COUNT OF THE READ DATA SAVED WHEN AN EOF WAS 
DETECTED. 

18 - DCNT 

DURING A WRITE, IT INDECATES THE NUMBER OF CHARACTERS TO BE 
WRITTEN BY THE CURRENT EXECUTION OF THE CHANNEL PROGRAM. DURING 
A READ, IT INDECATES THE NUMBER OF CHARACTERS TO BE READ BY THE 
CURRENT CHANNEL PROGRAM. WHEN=-2, IT INDECATES THAT ALL TANKED 
DATA HAS BEEN WRITTEN OUT AND THAT IOTERMO IS INTHE MIDDLE OF 
FILLING A TBUF. FILLING A TBUF. 

19 - DHEAD 

A SYSDB RELATIVE POINTER TO 

(1) DURING WRITE, THE CURRENT TBUF CONTAINING DATA TO BE WRITTEN, 

(2) DURING READ, THE 1ST TBUF ON THE LINKED LIST OF INPUT DATA. 

20 - DTAIL 

A SYSDB RELATIVE POINTER TO 

(1) DURING WRITE, THE LAST TBUF ON THE LINKED LIST OF TANKED DATA, 

(2) DURING READ, THE CURRENT TBUF USED FOR RECEIVING DATA. 

21 - DPNTR 

A WORD POINTER USED DURING WRITES TO INDICATE THE OFFSET WITHIN A 
TBUF OF THE 1ST BYTE OF DATA TO BE WRITTEN BY THE CURRENT CHANNEL 
PROGRAM. 
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22 - DPNTR 

A STSDB RELATIVE POINTER TO A LINKED LISTOF TBUF'S CONTAINING 
THE DATA SAVED WHEN AN EOF WAS DETECTED. 

23 - DLAST 

.TERMTYPE (0:7) - THE DEFAULT OR CONFIGURED TERM TYPE. WHEN THE 
TERMINAL IS SPEED SENSED, THIS IS THE TERM TYPE 
USED. 
.BINWRT (7:1) - SET IF THE LAST WRITE OPERATION WAS IN BINARY 

MODE. 
.EIGHTBITS (8:1) - SET IF THE 8-BIT PROTOCOL IS USED AND PARITY 

GENERATION/CHECKING IS DISALLOWED. USED FOR 
TERM TYPES 12 AND 15- 
.NEWFORM (9:1) - LAST CARRIAGE CONTROL WAS A FORM FEED. 
.DEFAULTSPEED (10:6) - THE ADCC CODE OF THE DEFAULT OR CONFIGURED 

TERMINAL BAUDRATE. 

2\ - DTBLK 

A DIT POINTER TO THE NEXT TERMINAL WAITING FOR A TBUF. 

25 - DNXTB 

A POINTER TO A TBUF ALLOCATED TO A TERMINAL WHICH HAS BEEN WAITING; 
THIS IS TO INSURE THAT A WAITING TERMINAL GETS AT LEAST ONE TBUF WHEN 
IT COMES TO THE TOP OF THE TBUF WAITING LIST. 

26, 27 - DRTIME 

DURING A TIMED READ OPERATION, THIS IS THE READING OF THE TIMER 
AT THE INITIATION OF THE READ. AFTER THE READ IS COMPLETED, THE 
TOTAL ELAPSED TIME IN 1/100 OF A SECOND IS SAVED INDRTIME AS A 
SINGLE WORD. IF IT IS -1 THEN THE ELAPSED TIME WAS GREATER THAN 
32K. 

28 - DRTMAX 

, WHEN A TIME LIMIT ON A READ OPERATIONS REQUESTED, THIS QUANTITY 
REPRESENTS THE MAXIMUM TIME (SECONDS) ALLOWED FOR THE READ OPERATION 
TO COMPLETE; IF THIS LIMIT IS EXCEEDED, THE READ OPERATION WILL 
BE TERMINATED. 

29 - DSYNC 

.LFSYNC (0:U) - CONTAINS THE NUMBER OF SYNC CHARACTERS TO BE SENT 
AFTER A LF IS OUTPUT 

.CRSYNC (U:U) - CONTAINS THE NUMBER OF SYNC CHARACTERS TO BE SENT 
AFTER A CR IS OUTPUT 

.SYNBCCOUNT (8:8) - SPECIFIED THE NUMBER OF DATA CHARACTERS THAT 

CAN BE TANKED BEFORE AN ENQ HAS TO BE INSERTED 
m xn& Tour . run wmxci unuuu'iuna xu a zoha 
TERMINAL, AFTER 80 CHARACTERS HAVE BEEN SENT 
SINCE THE LAST ENQ OR THE LAST READ OPERATION, 
AN ENQ HAS TO BE SENT AND THE WRITE SUSPENDED 
UNTIL AN ACK IS RECEIVED. 

30 - DBREAK 

WHEN A BREAK WAS DETECTED DURING A READ OPERATION, THE DATA ALREADY 
INPUT IS SAVED AND THIS WORD CONTAINS A POINTER TO AN IOQ USED TO 
STORE THE BYTE COUNT, TBUF HEAD AND TAIL OF THE SAVED DATA. 
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31,32 - DTRLS 

HOLDS TIMEOUT REQUEST INDICES 

• HOLDS THEN INDEX OF A 10 SECOND TIMEOUT REQUEST 
FOR THE ENQ/ACK HANDSHAKE/BLOCK MODE TIMEOUT 

- HOLDS THE LOGON, HANGUP AND TIMED READ TIME-F 
OUT REQUEST INDICES 

- HOLDS THE INDEX OF A TIMEOUT REQUEST DUE TO 
LOSS OF CARRIER DETECT FROM THE DATASET. 

■ HOLDS THE INDEX OF A TIMEOUT REQUEST FOR A LINE 
TURNAROUND ON A 202 DATASET. 



.26U0TRLX (0:8) 
.RREADTRLX (8:8) 
.CFAILTRLX (0:8) 
.TURNTRLX (8:8) • 



33 " DTANKB 

A COUNT OF THE BYTES TANKED IN THE LINKED TBUF'S; THIS COUNT IS 
USUALLY GREATER THAN DBCNT, THE COUNT OF BYTES REMAINING TO BE 
OUTPUT, BECAUSE THE DATA IN A TBUF IS SENT OUT IN BLOCKS SEPARATED 
BY AN ENQ. 

3U - DMONTR 

.LOGONTYPE (0:2) 

.SYNCSTATE (2:2) STATE OF TANKING LF/SYNC 

=> TANK XOFF/CR; 1=> DETERMINE LF'S TO TANK 
2 => TANK LF/SYNC 
.CFAILCNT {U:6) - A COUNT OF THE TIMES WHEN LOSS OF CARRIER 

DETECT FROM THE DATASET IS DETECTED DURING A 
READ OPERATION; WHEN THE COUNT EXCEEDS 50, THE 
USER IS HUNG UP AND THE DATASET DISCONNECTED 
.LFCOUNT (10:6) - NUMBER OF LF'S FOR %2NN CARRIAGE CONTROL 

35 - DSIOPC 

STORES THE POINTER TO THE CHANNEL PROGRAM WHICH IS TO BE STARTED 
WHEN A DATASET LINE TURNAROUND IS COMPLETE; THE CHANNEL PROGRAM 
TO BE STARTED IS EITHER FOR A READ OR WRITE OPERATION. 

36 - DBLKTAIL 

POINTER TO THE SECOND TBUF SEF FOR A READ OPERATION; 2 READ 
CHANNELPROGRAMS, EACH WITH ONE TBUF, ARE USED TO INSURE AGAINST 
DATA OVERRUNS DURING FAST BLOCK MODE READS. 
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LINE PRINTER DIT (SERIES II/III) 



There is one DIT per physical device. If a physical device 
represents more than one logical device, the logical device number is 
obtained from the IOQ element. The following diagram shows the DIT 
used for IOLPRTO. 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

0| 0| 0|AC|RQ| 0| 0| 0|IO|AK|PS|NE|TF| STATE | 
+--+--+--+--+--+--+--+--+--+--+--+--+ + 

1| SYSDB relative pointer to the DIT for the next| 
j device requesting this resource or service | 
+ -- + 

2 1 SYSDB relative pointer to the first IOQ in j 
| request list for this device I 

+ — + - + 

3 1 | Phys unit # j Logical device number | 
+ + + 

U| SYSDB relative pointer to Device Linkage Table | 
+ -- — -"+ 

5| SYSDB relative ptr to Interrupt Linkage Table | 
+ - + 

6 1 Controller interrupt status. Set by GIP each | 
I time it processes an interrupt for this DIT. j 
j See individual field descriptions on nxt page.| 
+ — + 

7| Hardware error pointer. Set when the driver | 
j detects an error. Whenever <> 0, the driver | 
| monitor logs an I/O error and clears this word| 

+ + 

%10| Bit is set at completion of 2-second timer. | 

%11| Timer Request List Index. Not used except to | 
I clear the request after timing out. I 

+ + — + 



»12| 



I 



+--+--+ — +--+ 

%13|VF|PF|BT|TL|Left margin 

|MD|RS|JB|NR| 

+--+--+--+--+ 

%lU| Lines left to skip 

j (subtypes 1, 2, >15 

| line slew request) 

+ + 

%15l HARDWARE ERROR LOGGING STATUS 

+ 

%16| DVR DEPENDENT FLAGS => |PS|NE|TF| 



Last byte if odd bytcntl 
Data byte for VFC or | 
left margin download | 

+ 

Vertical Format Code | 



%202 (2608) or %102. | 
Skip to channel 3 pre-j 
to postspace print. | 



MNEMONIC 

DFLAG 

DLINK 

DIOQP 

DLDEV 
DDLTP 
DILTP 
DSTAT 

DSERR 

DTIME 
DTRLX 

DLAST 

DVFC1 
DVFC2 

DL0GERR0R 
DDF 
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DFLAG.AC 
DFLAG.RQ 

DFLAG.IO 

DFLAG.AK 

DDF .PS 

DDF ,NE 



Active. A monitor is currently servicing this device. * 
Request. A service request is pending while the monitor 
is active. * 

An I/O channel program is in progress. Decrement SIOCOUNT 
and check for multiple channels when complete. * 

Interrupt Acknowledge. An interrupt has occurred. * 

Prespace. The last request was a prespace (space then 
fill buffer) operation. 

Not Empty. The print buffer is not empty. Causes a print 
when changing from pre- to postspace or before ejecting 
a page for a File Open, File Close or Device Close. 

Top of Form. The last request ended with a skip to 
channel 1 (page eject). 

* Not examined or modified by IOLPRTO. 

DFLAG.STATE - State of the device monitor. Specifies the next action 
to be taken by SIODM in servicing the request. Not 
used within IOLPRTO . 



DDF .TF 



DSTAT. (0; 
.(1: 

.(2: 
• (3: 
.(5 



1) 

1) 

1) 
2) 
1) 



.(6:1) 



(7: 
(8: 



1) 
3) 



SIO OK. Set when no SIO channel program is in progress, 
that is, it is OK to start one. 

WIO OK. Set when it is OK to execute a WIO instruction 
or a doubleword WRITE channel order. If clear, 
indicates that a one word transfer is in progress. 

- Interrupt Pending. If set, indicates one or more bits 

of the Interrupt Status Byte (DSTAT. (8:8) are set. 
-U.I. Transfer State. Used mostly for hardware mainten- 
ance. See U.I. card manual (3OO51-90OO1) for details. 
Device Flag. Indicates a print -and -advance -paper 
sequence in progress. Since the 2608 buffers such 
commands, this signal may be shorter than with other 
printers . 

- Always 0. DSTAT. (8:8) always contains the Interrupt 

Status Byte. 

- Not used. Always 0. 

- Varies among HP-supported line printers according to 

the table below: 



SUBTYPE MODEL (S) 



BIT 8 



BIT 9 



BIT 10 






2610, 


26llt 


LINE 
PRINTED 


READY 


NOT 
READY 


1 


2607 




Not 
used 


READY 


NOT 
READY 


2 


2613, 
2619 


2617, 2618, 


Not 
used 


READY 


NOT 
READY 


3 


2617J 


(KATAKANA) 


Not 
used 


READY 


NOT 
READY 


k 


2608 




ON 
LINE 


NOT 
READY 


VFC 

CHAN 9 
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.(11:1) 
•(12:1) 
.(13:1) 



(1»»:1) 



•(15:1) 



DLAST.(8:8) 



Data Transfer Interrupt bit. Always 0. 
Not used. Always 0. 

Programmed Interrupt bit. True if interrupt request 
was generated by: 

a) SIN machine instruction, 

b) INTERRUPT channel order, or 

c) END-WITH-INTERRUPT channel order. 
Transfer Error Interrupt bit. True 

generated by: 

a) an illegal memory address, 

b) a memory parity error, or 

c) a multiplexer parity error during data xfr to 
Time-out Interrupt bit. Set if 5-second timer on 

card is enabled, then times out without 
cleared. 



if interrupt was 



U.I. 

U,I. 

being 



DVFC1.(0:1) - 
DVFC1.(1:1) - 

DVFC1.(2:1) - 

DVFC1.(3:1) " 
DVFC1.(U:U) - 

DVFC1.(8:8) - 



Request dependent. If a print request has an odd 
number of bytes, this word holds the final byte. For 
VFC downloads, contains the associated data byte (6 
or 8 lines per inch and number of lines in VFC). For 
left margin downloads, also contains the associated 
data byte (the number of columns to offset). 

VFC Modified. 2608 only. Indicates that an external 
VFC has been downloaded into the 2608. 

Power Fail/Reset. 2608 only. The 2608 has suffered a 
Power Failure or someone has pressed the front panel 
Reset button. In either case, the printer's operating 
environment has been destroyed, and must be reloaded 
by the operator. 

Between Jobs. Set when a Device Close is executed, 
cleared when an FOPEN is performed. 2608 Power Fail/ 
Master Reset's will be cleared but not reported while 
this bit is set (thus avoiding an extraneous console 
message when the printer is powered up) . 

TALLY 'NOT 'READY. Set when an off-line condition 

is detected on a 2607. Causes a three-second 

delay when the 26 07 comes back on-line. 

Left margin offset (2608 only). Stored during 
each :DOWNLOAD which specifies a left margin 
and restored to printer following a 2608 power 
fail or reset. Set to when system is ini- 
tialized. 

Request dependent. Contains the carriage control byte 
sent to the printer during a print request. 
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DVFC2.(0:8) - LINES 'LEFT' OVER. Has two functions: 

1) The 2607/13/17/18/19 can only slew (skip) a 
maximum of 15 lines per print command (not 
counting VFC skips, which can be of any 
length). Slew requests > 15 lines must be 
broken up. This byte holds the number of 
lines (greater than 15) which remain to be 
slewed at any point of a request to such a 
printer, or if the number of lines to skip 
is <= 15. This mechanism is not needed (and 
this field is therefore 0) for CDC and 2608 
line printers, which can slew up to 63 lines 
at a time. 

2) The carriage control characters "0" in "-" 
specify double and triple spacing, respective- 
ly. But if you use the equivalent channel 
skip, you get skips to the next odd and third 
lines, respectively, which is not the same as 
double and triple spacing. If you slew (ad- 
vance paper) 2 or 3 lines, you can easily 
print over the paper perforations unless your 
program watches out for such things. We avoid 
this by examining the NO' AUTO" PAGE eject bit 
(I0Q(QPAR2).(lU:l)). If it is set, then the 
request is treated like a normal slew and 
LIKES* LEFT' OVER is not used. If it is clear 
(auto eject desired), then we simulate the 
multiple line skip by doing two ("0") or three 
("-") skips to channel 3 (single spaces with 
auto page eject for the standard VFC). In 
this case, LINES 'LEFT' OVER holds the number of 
such single spaces remaining in the request. 

DVFC2.(8:8) - %202 for 2608, %102 otherwise. Causes skip to channel 
3 (single space with auto page eject). Used when 
last request left data in print buffer (prespace) and 
current operation is postspace. Buffer is dumped 
first, using this byte as carriage control. 
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2608 LINE PRINTER DIT (HPIB SYSTEMS) 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element (however, there is only one device per 2608 
controller.) The following diagram shows the DIT used for the 
2608 line printer driver. 

1 2 3 *» 5 6 7 8 9 10 11 12 13 1U 15 MNEMONIC 

0| 0| 0|AC|RQ| 0| 0| 0|IO|IA|NO|ST| 0| STATE | DFLAG 
+ — +--+ — +--+ — +__+__+__+__+__+__+__+ + 

1| S7SDB relative pointer to the DIT for the next| DLINK 

I device requesting this resource or service | 
+ + 

2 1 S7SDB relative pointer to the first IOQ in | DIOQP 

j request list for this device j 

+ + + + 

3|IOT I Phys. unit # | Logical device number | DLDEV 
+ + + + 

U| STSDB relative pointer to Device Linkage Table | DDLTP 
+ + 

51 STSDB relative pntr to Interrupt Linkage Table | DILTP 
+ + 

6|VM| I TAB I |PS|FL|TP| DSAVE 
+ + 

71 Hardware error pointer. Set when the driver | DSERR 

I detects an error. Whenever <>0, the driver j 

I monitor logs an I/O error and clears this wordj 
+ — + + + + — + — + — + 

%10| Bit is set at completion of timer | DTIME 

+ — + + + . + — +--+--+ 

%11| Holds the time out request entry index while | DRQST 

I a timer is active. j 

+ + 

%12| Hardware logged error status | DLOGERROR 
+ + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

10 I0PR0G 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
active. 

- An I/O Channel Program is running for this device. 

- Ah interrupt or response has occurred for this device. 

- Go to state %10 after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODM in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
U - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 
IOT I/O TYPE- Type of I/O system 

- HP3000 Series II /I I I 

1 - HP3000 Series 33 (HP-IB) 

2 - unused 

3 - unsused 

DSAVE - Device processing flags 

VM VFCMOD - VFC has been modified. 

TAB TABDFAULT - System tab default. 

PS PRESPACE - Last request used prespacing. 

FL FULL - Line printer buffer is full. 

TP TOP - Printer is at top of form 
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2608 Line Printer Status 



BYTE 1 & BYTE 2: 
BITS USE 



ON LINE 



1 
2 
3 

k 

5 
6 

7 
8 

9 

10 

11 
12 

13 
1U 

15 
BYTE 3: 
BYTE U: 

BYTE 5: 



BYTE 
BYTE 
BYTE 
BYTE 
BYTE 10 
BYTE 11 
BYTE 12 
BYTE 20 



NOT READY 

VFC CHANNEL 9 (BOTTOM OF FORM) 

VFC CHANNEL 12 (TOP OF FORM) 

VFC INITIALIZED 
6/8 LINES PER INCH 
(NOT USED) 

POWER RESTORED/UNIT RESET 

ON LINE 

PRINT MECH ERROR 

SELF TEST FAILURE 
PAPER ERROR 
SELF TEST MODE 

6/8 LPI 

PLATEN/RIBBON ERROR 
(NOT USED) 

PRINT MODE 

BITS 0-7 MODE NUMBER 

PRIMARY/SECONDARY 

BITS 0-3 SECONDARY CHARACTER SET CODE 

BITS U-7 PRIMARY CHARACTER SET CODE 

SELF TEST 

BITS PASS FAIL 

BITS 1-7 SUBTEST NUMBER 

6 LPI DOT ROW COUNT 

6 LPI FORM LINE NUMBER 

6 LPI FORM LENGTH IN LINES 

8 LPI DOT ROW COUNT 

8 LPI FORM LINE NUMBER 

8 LPI FORM LENGTH IN LINES 

FIRMWARE IDENTIFICATION CODE 

POWER-UP LANGUAGE 

BITS 0-3 SECONDARY CHARACTER SET CODE 

BITS U-7 PRIMARY CHARACTER SET CODE 
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2619A OR 2631 LINE PRINTER DIT (FOR HPIB SYSTEMS) 



There is one DIT per physical device. If a physical device represents 
more than one logical device, the logical device number is obtained 
from the IOQ element (however, there is only one device per 2631 
controller.) The following diagram shows the DIT used for the 
2631 line printer driver. 

1 2 3 U 5 6 7 8 9 10 11 12 13 Ht 15 MNEMONIC 

0| 0| 0|AC|RQ| 0| 0| 0|IO|IA|NO|ST| 0| STATE | DFLAG 
+ — + — +--+ — + — + — +--+ — + — +_-+__+-.+ + 

1| SYSDB relative pointer to the DIT for the next| DUNK 

I device requesting this resource or service j 

+ - - --+ 

2 1 SYSDB relative pointer to the first IOQ in | DIOQP 

j request list for this device j 

+ + + + 

3|IOT I Phys. unit f | Logical device number | DLDEV 

+ + +— + 

U| SYSDB relative pointer to Device Linkage Tablej DDLTP 

+ + 

51 SYSDB relative pntr to Interrupt Linkage Table | DILTP 

+ + 

6| |BJ|AB|PS|FL|TP| DSAVE 

+ + 

71 Hardware error status. Set when the driver | DSERR 

I detects an error. Whenever <>0, the driver j 

I monitor logs an I/O error and clears this wordj 

+ - + 

%10| Bit is set at completion of timer | DTIME 

+ + 

%11| Holds the time out request entry index while | DRQST 

I a timer is active. j 

+ — -+ 

%12| Hardware logged error status | DLOGERROR 

+ - + 



DFLAG - Flags 

AC ACTIVE 

RQ REQUEST 

10 IOPROG 

IA IAK 

NO NOTRDY 

ST STWAIT 



and request state 

- A monitor is currently servicing this device. 

- A service request is pending while the monitor is 
active. 

- An I/O Channel Program is running for this device. 

- An interrupt or response has occurred for this device. 

- Go to state %10 after Idle Channel Program is started. 

- The device monitor is starting an Idle Channel Program 
for this device. There is no IOQ associated with this 
type of request. 
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STATE - State of the device monitor. Specifies the next action 
to be taken in SIODK in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver completor procedure 
k - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

%10 - wait for interrupt (operator intervention) 

restart at state 
%11 - wait for data segment freeze, then state 2 
%12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
%13 - wait for I/O completion interrupt, then state 3 
%lk - wait for controller, then call driver initiator 
%15 - not used 

%l6 - wait for initiator make present, then state 2 
%17 - wait for completor make present, then state 3 

DLDEV - I/O system type, unit and logical device number 
IOT I/O TYPE - Type of I/O system 

- HP3000 Series 2/3 

1 - HP3000 Series 33 (HPIB) 

2 - Unused 

3 - Unused 

DSAVE - Device processing flags 

BJ BETJOB - Between jobs flag. If set, suppress 

Powerfail message. 
AB ABORT - Abort (caused by Powerfail or Operator) 

has occurred. 
PS PRESPACE - Last request used prespacing. 
PL FULL - Line printer buffer is full. 
TP TOP - Printer is at top of form 
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2680A DIT 



1 2 3 k 5 6 7 8 9 10 11 12 13 Ik 15 
DITO !0 !0 !AC!RQ!0 !0 !SP!CP!IA!NR!SW! ! STATE ! DFLAG 



1 
2 

3 
k 

5 
6 

7 



! POINTER TO NEXT DIT 1 DLINK 

! POINTER TO ACTIVE IOQ OR ZERO I DIOQP 

! IOT ! UNIT NUMBER 1 LOGICAL DEVICE NUMBER ! DLDEV 

! DRIVER LINKAGE TABLE POINTER ! DDLTP 

! INTERRUPT LINKAGE TABLE POINTER ! DILTP 



i 



8 !T ! 

9 1 

10 ! 

11 ! 

12 1 



SPECIAL ERROR CONDITIONS TO BE LOGGED 
ERROR LOGGING INFORMATION 
TIMEOUT INDICATION IN BIT 
TIMER REQUEST INDEX (TRL) OR ZERO 
CURRENT DATA WRITE BITE COUNT 
CURRENT DATA WORD COUNT 
# OF WORDS LEFT TO TRANSFER 



13 ! BUFFER OFFSET FOR NEXT # OF WORDS TO XFER. 
Ik i MCS FAULT NUMBER TO BE LOGGED 



15/29 ! I/O STATUS AREA (16 WORDS, SEE DEFINITION) 

+ — + — + — + — + — +--+-_+--+ — + — + — +__+__+. _+__+._+ 



DSTAT 

DSERR 

DTIME 

DTRLX 

DCBCNT 

DCWCNT 

DRCNT 

DOFFSET 

DLOGBUFFER 

DIOSTAT 



DFLAG - DEVICE RELATIVE FLAGS. 

AC ACTIVE BIT. 1 IMPLIES A MONITOR CURRENTLY 

SERVICING THIS DEVICE. 
RQ REQUEST BIT. 1 IMPLIES SERVICE REQUESTED 

WHILE MONITOR IS ACTIVE. 
SP SIO PREEMPTION. IF SET THEN A PREEMPTIVE 

REQUEST HAS BEEN QUEUED FOR THIS DEVICE. 

PREEMPT CODE IS SET IN IOQ ELEMENT. 
CP CHANNEL PROGRAM IN PROGRESS. IF SET, THEN 

A CHANNEL PROGRAM IS CURRENTLY EXECUTING. 
IA IF SET, AN INTERRUPT OR RESPONSE HAS OCCURED. 
NR IF SET, DEVICE IS IN A NOT READY OR OPERATOR WAIT. 
SW IF SET, AN IDLE CHANNEL PROGRAM SHOULD BE STARTED 

FOR THIS DEVICE. 
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MSTATE CURRENT DRIVER STATE AS DEFINED BY THE MONITOR. 
ALLOWABLE STATES ARE: 

- START REQUEST 

1 - NOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COMPLETOR 

4 - UNUSED (BUT RESERVED) 

5 - COMPLETE REQUEST .. PERHAPS RETURN TO USER. 

6 - UNEXPECTED INTERRUPT OCCURRED. 

7 - START OPERATOR INTERVENTION WAIT. 



»10 - WAITING 

11 - WAITING 

12 - WAITING 

13 - WAITING 

14 - WAITING 



ON OPERATOR). RESTART AT 0. 

DATA MAKEPRESENT/FREEZING) 

INITIATOR CODE MAKEPRESENT/FREEZE) 

FOR COMPLETION INTERRUPT) 

FOR DEVICE CONTROLLER AVAILABILITY) 

15 - UNUSED (BUT RESERVED) 

16 - WAITING (INITIATOR CODE MAKEPRESENT) 

17 - WAITING (COMPLETOR CODE MAKEPRESENT) 

DLDEV - I/O SYSTEM TYPE, UNIT AND LOGICAL DEVICE NUMBER. 
IOT I/O SYSTEM TYPE. 

- HP3000 SERIES II/III (SIO/DIO) 

1 - HP-IB 

2 - RESERVED 

3 - RESERVED 

DCBCNT - CURRENT BYTE COUNT TO BE TRANSFERRED. 

DCWCNT - CURRENT WORD COUNT TO BE TRANSFERRED. 

DRCNT - REMAINING WORD COUNT TO TRANSFER. 

DOFFSET - OFFSET IN BUFFER OF NEXT # WORDS TO TRANSFER. 

DDEBUG - IF BIT 15=1 THEN DEBUGGING INFO WILL BE SENT TO CONSOLE 

DLOGBUFFER - STATUS WORDS 1 & 3 ARE MOVED HERE TO BE LOGGED 
IF THEY WERE LOGGED FROM THE I/O STATUS BLOCK 
THEIR CONTENTS MIGHT BE CHANGED BEFORE THEY 
WERE LOGGED. 

DIOSTAT - I/O STATUS AREA 16 WORDS, SEE I/O STATUS BLOCK DEFINITION. 
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I/O STATUS BLOCK 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+ — + — + — + — + — + — + — + — + — + — + — + — + — + — + — + — + 

1— THE "OR" OF WORDS 1/15 IS LOCATED HERE ! DIT 17 

— + — + — + — + — + — + — + — + — + — + — + — + — + — + — + — + 

OF!MS!PW!PE!TE! !!!!!!!!!!! 
__ + — +--+ — +__+„_+__+_-,+__+., _+_-+--+--+ — + — + — + 

! ! ! ! ! (RESERVED) !!!!!!! 
. — + — + — + — +--+ — + — + — + — + — + — + — + — + — + — + — + 

MCS FAULT NUMBER ! 

-+ — + — + — + — + — + — + — + — + — + — + — + — + — + — + — + 



CL 
LP 



FL 
PF 



VL 
NC 



CU 



FU 



IR 



MP 



NJ 



NM 



TL 



NC! 
— + 

j 
— + 

j 
— + 

j 
• — + 

i 
■ — + 



VU!IL!IP!ST!SB 
— +--+ — +__+__. 

(RESERVED) 
— +--+ — + — +-- 

(RESERVED) 
— + — + — +--+--■ 

(RESERVED) 
--+ — +--+ — +-- 

(RESERVED) 
— -+--+ — + — + — 

(RESERVED) 
--+--+ — + — + — 

(RESERVED) 
— +--+ — + — + — 

(RESERVED) 

+— + — + — + — + — + — + — + — + — + — + — + — +--+ — + — + 

RECORD NUMBER OF ERROR t 

IF WORD 4 IS — + 

NON-ZERO ! 

+ — + — + — + — + — + — + — + — +--+ — + — +--+ — + — + — + 

SHEET NUMBER OF ERROR IF WORD 4 IS NON-ZERO ! 

+— OR — + 

15 ! LAST SHEET TRANSFERRED IF "JOB" & POWER-ON ! 

+ — + — + — + — + — + — + — + — + — + — + — + — + — + — +--+ — + 



18 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 



WORD - EACH BIT IS THE 'OR' OF ONE WORD IN THE TABLE (EXCEPT 

BIT WHICH IS NOT USED). THEREFORE, BIT .(1:1) IS SET 
IF WORD 1 IN THE TABLE IS NON-ZERO. 

WORD 1 - BIT= - (OF) ONLINE/OFFLINE BIT. 

1 - (MS) MESSAGE BEING DISPLAYED ON THE 2680A CONSOLE. 

2 - (PW) POWER UP COMPLETED SINCE LAST I/O STATUS READ. 

3 - (PE) PARITY ERROR DETECTED ON PHI COMMAND. 

4 - (TE) TRANSMISSION ERROR DETECTED IN THE PRINTER. 
5/15 - RESERVED. UNUSED. 

WORD 2 - NOT USED. RESERVED. 

WORD 3 ~ MCS FAULT NUMBER. CONTAINS AN INTEGER DESCRIBING THE LAST 
FAULT TO OCCUR SINCE THE LAST TIME THE I/O STATUS WAS READ 
OR THE HP2680A WAS POWERED DOWN. IF THE WORD IS ZERO THERE 
IS NO MCS FAULT. SEE DCS ERS FOR A DESCRIPTION OF THE MCS 
FAULT NUMBERS. 
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WORD A - BIT= - (CL) NO ROOM FOR ATTEMPTED CHARACTER SET LOAD. 

1 - (FL) NO ROOM FOR ATTEMPTED FORM LOAD. 

2 - (VL) NO ROOM FOR ATTEMPTED VFC LOAD. 

3 - (CU) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED CHARACTER SET. 

4 - (FD) ATTEMPT TO SELECT AN UNDEFINED FORM SET. 

5 - (VU) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED VFC SET. 

6 - (IL) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED LOGICAL PAGE TABLE (LPT) ENTRY. 

7 - (IP) ATTEMPT TO MOVE PEN OFF THE LOGICAL PAGE. 

8 - (ST) THE 2680A COULD NOT PROCESS ALL OF THE DATA 

BEFORE IT WAS SUPPOSED TO BE TRANSFERRED TO THE 
DRUM/PAPER. DATA WAS LOST! 

9 - (SB) SPOOLER BLOCK CONTAINS FORMAT ERROR. 

10 - (IR) INVALID RECOVERY BLOCK RECEIVED FROM SPOOLER. 

11 - (MP) MAXIMUM NUMBER OF COPIES PER PHYSICAL PAGE 

HAS BEEN EXCEEDED. THIS IS A RESULT OF THE 
SPOOLER PROCESS SETTING THE MAXIMUM COPIES PER 
PAGE WITH FUNCTION CODE 132. 

12 - (NJ) A COMMAND OR FUNCTION CODE WAS RECEIVED WHEN NO 

"JOB" WAS IN PROGRESS. THE COMMAND OR FUNCTION WAS 
IGNORED BY THE DCS. 

13 - (NM) NO MEMORY. 2680A DYNAMIC MEMORY ALLOCATION HAS 

DETECED THAT MAIN MEMORY IS COMPLETELY OCCUPIED WITH 
CHARACTER SETS, VFC'S, FORMS AND DATA SUCH THAT THE 
2680A CANNOT PROCESS THE CURRENT INPUT DATA. DATA 
WILL BE LOST! 

H " (TL) ATTEMPT TO PRINT DATA AND THERE ARE MORE THAN 
THE MAXIMUM ALLOWABLE LOGICAL PAGE TABLE (LPT) 
ENTRIES SELECTED. 

15 - (NC) A NON-EXISTENT VFC CHANNEL WAS SKIPPED TO. 

WORD 5 - BIT= - (LP) LOGICAL PAGE TRUNCATED TO FIT PHYSICAL PAGE. 

1 - (PF) PAGE SIZE PEQUIRED BY PROGRAMMER DID NOT 

MATCH PAGE SIZE SET BY OPERATOR. OPERATOR PAGE 
SIZE PREVAILS. 

2 - (NC) NO CHARACTER SET SELECTED. 

WORDS 6/11 NOT USED BUT RESERVED FOR FUTURE USE. 

WORDS 12/13 - THE RECORD NUMBER WHICH CONTAINS THE OFFENDING ERROR 

AS DEFINED BY WORD FOUR. IF A POWER FAIL OCCURS DURING 
A "JOB", THE POWER FAIL BIT IS SET AND A SHEET NUMBER IS 
MADE AVAILABLE IN WORDS FOURTEEN AND FIFTEEN. HOWEVER, 
THE RECORD NUMBER IS LOST AND CANNOT BE REPORTED. THESE 
WORDS OCCUR IN A "JOB" ONLY. 

WORDS 14/15 - THE SHEET NUMBER ON WHICH THE ERROR OCCURED AS DEFINED 

BY WORD FOUR. IF AN ERROR OCCURS IN THE ENVIRONMENT FILE 
AT THE START OF A "JOB", THEN THIS NUMBER WILL BE ZERO. 
IN ADDITION, WHEN A POWER FAIL OCCURS DURING A "JOB", 
THE POWER ON BIT IS SET IN WORD ONE AND THE SHEET 
NUMBER OF THE LAST SUCCESSFULLY TRANSFERRED PAGE IS 
PLACED HERE. THIS INFORMATION IS FOR USE BY THE 
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SPOOLER SHOULD A RECOVERY OF A "JOB" BE DETERMINED. 
THESE WORDS OCCUR IN "JOB" ONLY. 



ALL WORDS OF THE I/O STATUS ARE CLEARED WHENEVER THE STATUS BLOCK 
IS RETURNED TO THE HOST. IT IS UP TO THE HOST CPU TO RETAIN ANY ON- 
GOING STATUS BITS REQUIRED. 
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30119 CARD READER/PUNCH DIT 

Everything is the same as the SIO DIT 
and standard IOQ except as noted below: 



1. DIT (9) 



1 2 3 U 56789 10 11 12,13 l 1 * 15 

|C |S |S |H |I |E |I |P |P |S |E |S |M |C |T | 
%11 I B I I I I I I I I I I P I I I I I I DACCP 
I F| C| S| S| F| F| B| R| N| D| C| m| D | N| R| 
I I I I I I I I I I I I I E I I I 



DIT(9).(0:1) 



CBF 



DIT(9).(1:1) 


SC 


DIT(9).(2:1) 


SS 


DIT(9).(3:1) 


HS 


DIT(9).(U:1) 


IIP 


DIT(9).(5:D 


EOF 


DIT(9).(6:1) 


IB 


DIT(9).(7:D 


PR 


DIT(9)-(8:1) 


PN 


DIT(9).(9:D 


SPD 


DIT(9).(10:1) 


EC 



Clear Buffer Full - s the next card leaving 
the hopper will be read by the device. 
1= the read buffer will be cleared when 
next card leaves the hopper. 

Stacker Control - 0=all cards axe stacked in 
right hopper until device goes not ready. 
1= cards are stacked per bit 2. 

Stacker Select - 0=Right stacker (stacker 1) 
1= Left Stacker (stacker 2). 

Hopper Select - s Pick from rear hopper 
(primary hopper) . I s Pick from front hopper 
(secondary hopper). 

Inhibit Input Feed - Inhibit picking a card 
when card currently in wait station is eject 
to a hopper. 

End Of File has been detected on a read oper 

Internal Buffer -An internal buffer is being 
used. The buffer is the SIO area in the ILT. 

Print - Print on the next card to pass the 
print station. 

Punch - Punch 80 columns of data on the next 
card to pass the punch station. 

Separate Print Data - Print data other than 
that being punched on the next card to pass 
the punch and print station. 

Eject Card - Eject on a write after a read. 
Used when reading one card then punching one 
card (last card was read). 
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30119 CARD READER/PUNCH (CONT. ) 



DIT(9).(11:1) 
DIT(9).(12:2) 

DIT(9).(lU:l) 

DIT(9).(15:1) 



Sm 
MODE 



CON 



TR 



Stacker Mode -Saved staker mode on last read 

Access Mode - 

0= File opened for Read only 

1= File opened for Write only 

2= File opened for Read/Write 

Control - 0= no FCONTRL has occured for this 
file (use default settings). 1= FCONTROL has 
been done on this file (use settings in this 
DIT word for controlling this device). 

Timer Request - A timer request is pending. 
Timer request index is in word %12. 



'2. DIT(IO) Timer request index (see DIT(9) . (15:1)). 



3. QHISC{IOQ(U)) 
1 2 3 U 5 



6 7 8 9 10 11 12 13 lU 15 



II IH |W | 
I I R I 1 
I 0| ■ I| R| 



UNUSED 



IOQ(U).(0:1) 10 
I0Q(U).(1:1) 
I0Q(U).(2:1) WR 
IOQ(U).(3:13) 



I/O initiated - waiting for completion 
interrupt . 



NRI Waiting for a "Not Ready Interrupt" to 
bring the device back online. 



Write - current operation is a write 
operation. 

Not Used 
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BINARY SYNCHRONOUS COMMUNICATION FOR CS DIT 



1 2 3 U 5 6 7 8 9 10 11 12 13 lb 15 



I-I--I--I--I-I--I 



I 
0| 

I 

I- 
II 

I" 
21 

I- 
31 

I 



|AC| 
|TV| 
I I 



|SI|IN| 
|0-|T-| 
| ON | AC | 



NEXT DITP 
IOQP 



UNIT 



DLDEVN 



DLTP 



ILTP 



61 



|TO|LO| 

I |c-| 

I |TO| 



71 

I- 

10 1 

I- 
111 

I- 
12| 

I- 
131 

I- 
1U| 

I 



HARDWARE STATUS 
RESERVED 



CONTROL P 
LCM' DITP 



EDIT' DITP 
PD' DITP 



I 

(2)17 1 SUBTYPE I DEV. TYPE 

I 

(3)20| TRANSFER LENGTH 



|DR|ON 
|V-|LI 
|EN|NE 



|CM| |PW| |HD|SF| |TO| |BF|ID|US| |LO| 
(0)15|P-| IR-I |AB|AB| | | |FZ|FZ|ER| |C-| 
|IN| |FL| IT |T | | | | | |RQ| |TO| 



|CM| |PW| |HD|SF| |TO| | BF | ID | US | |LO| 

(1)16|P-| |R-| |AB|AB| | | |FZ|FZ|ER| |C-| 

UNI |FL| |T |T | | | | | |RQ| |TO| 



I 



LCN 



(U) 21 | LAST RECOVERABLE ERROR 

I 

(5) 22 | WAIT QUEUE 



ERROR CODE 



|IN|IN|TR|IN|SPEED| CS | CS 
(6)23|H-|H-|C-|H-|SELEC| MODE | CODE 

|TO|ID|SP|CL| | | 

| 



ACTV=ACTIVE 

INT-AC=INTERRUPT 

ACKNOWLEDGE 
DRV-EN=DRIVER 

1 ENTERED 

2 

3 
k 

5 

TO=TIMEOUT 
6 LOC=LOCAL 

7 
8 

9 
10 
11 
12 

13(0) MASK 

1U(1) FLAG 

15(2) LINE INFO 

16(3) 
17(b) 

18(5) 

19(6) COPTIONS 
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CS DIT (CONT. ) 



(7)2U| 



I 
(11)26| 

I- 
I 

(12)271 
I 
I- 

(13)30| 

I- 
(1U)3U 

I- 
(15)32| 

I- 
(16)331 

I 
(17)3M 

I- 
(20)351 

I 
(21)361 



PROTOCOL 



I 



I DIAL | IN | CO 
ITYPE |H-|N- 
I |BF|IO 



15) 



( 1 2 3 U 5 6 7 8 9 io 11 12 13 lU 

I |RE|NO|DS|END |LD|AS|DB|DB|EX|MFW |CH|NUM 

(10)251 IM-|-R|B-|SEQN |-G|-B|WK|T |-I|TYPE |A-|SYNCS 

I |WT|VI|CT| |PH|CC| |TD|TB| |WR| 



|CO| 
|DE| 
|SN| HSI CHAN 



|AB|DU|HA|XMSN |SP| 
|T-|AL|LF| |D-| 
|AK|SP|SP|MODE |CH| 



|IO| 
IPRI 
I ESI 



CS MISC DSTN 



RECEIVE TIMEOUT 

LOCAL TIMEOUT 
CONNECT TIMEOUT 



INSPEED CHRS/SEC 



OUTSPEED CHRS/SEC 



(0 1 2 3 U 5 6 7 8 9 10 11 12 13 114 15) 
(22)37|RE|RE|TR|TR|IN|DI|ID|ID|ID|1 |2 |MS|AB|FI|PA|AB 

|QU|CV|C0|PD|HN!RT|BI|FR|ER|ST|ND|TA|TL|ND|DA|PO 
|SD|ER|MP|RV|DL|BF|TS|ZN|R |IN|IN|TR|AT|ID|DD|LL 



I 
(23)U0| 

I 
I 
I 
I 

(2U)Ul| 
(25)U2| 



MISC ARRAY 



TIME 
(CHRONOS TIME OF LAST 
CONNECTION) (CALENDAR&CLOCK) 



(25)U3| 

I 

(27)kk\ 



§ MESSAGE SENT 



20(7) AOPTIONS 



21(8) DOPTIONS 

MISC 

22(9) 

DSTINFO 
23(10) 

2U(11) 
25(12) 
26(13) 
27(lU) 
28(15) 
29(16) 
30(17) 

31(18) FLAGS 

32(19) 

33(20) 
3U(21) 
35(22) 
36(23) 
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CS DIT 

(30)1*51 
(3DU6| 


(CONT. ) 


# MESSAGES RECV'D 


37(2U) 
38(25) 








(32JU7I 


RECOVERABLE ERRORS 


39(26) 


(33)501 


IRRECOVERABLE ERRORS 


1*0(27) 


(3*0511 


COMPLETION CODE | TIMEOUT CODE 


ill (28) 


(35)521 


LOCAL TRLX TIMEOUT 


1*2(29) 


(36)531 


1 2 


TIMEOUT TRLX 
8 


1*3(30) 

TRWR=TRACEWRAP 

TRAL=TRACE ALL 

*»**(31)TRDR=TRACE 


(37)5**l 


TR|TR| |TR| 

ALJWRJ TRACE MASK |DRj TRACE ENTRY NUM 


(**0)55l 


MAX ENTRTS | CURRENT RETRYS 


DRIVER 

l»5(32) 


(**1)56| 


LINE 


STATE | 


**6(33) 


(**2)57l 


XMSN LOG 


**7(3*0 


(U3)60| 


CTS 


DELAY | PREEMP ERROR 


**8(35) 


(UU)6l| 




1*9(36) DRIVER 


(U5)62| 


CNTRLSEQ 


50(37) PARM1 


(1*9)631 
(J»7)6»»| 


TIMEOUT 
VALUE 


5K38) DRIVER 
52(39) PARM2 


(50)651 


OUTPUT BUFFER BANK 


53(**0) DRIVER 


(51)66 


OUTPUT BUFFER 


5**(**D PARM3 


(52)67 


OUTPUT BUFFER LENGTH 


55(**2) DRIVER 


(53)70 


INPUT BUFFER BANK 


56(U3) PARMl* 


(5*071 


INPUT BUFFER 


57(**U) DRIVER 


(55)72 


INPUT BUFFER LENGTH 


58(**5) PARM 5 


(56)73 


12 
TR|TR|TR| 
CE|CC|CF| 
RR|OM|LH| 


6 7 8 

I IN | DS | RESPONSE 
|& |R | TIMEOUT 
I PL | DL j 


5**(**6) 


(57)7U 


BID TIMEOUT 


60(1*7) 
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CS DIT (COHT.) 



1— 

(o 1 

(6o)75lPO| 

|LC| 

|HG| 


1 
1 
1 


BLOCK SIZE 1 


(6l)76| 




SEND MFW j 


(62)77| 




AGGREGATE XLOG | 


(63)100 | 


REQ STATION 


18 ) 
| CURRENT STATION 


(6U)101( 


# POLL ENTRIES | POLL LIST INDEX 


(65)102| 




TRACE IOQ I 


(66)1031 




POLL ENTRY DELAY | 


(67)10fc | 




POLL REPEAT | 


(70)1051 




POLL LOOP DELAY | 


(71)106| 




CONFIG BUFFER SIZE 


(72)1071 
(73)110| 





REQUEST IOQ | 
HARD ABORT IOQ | 


(7U)111| 




SOFT ABORT IOQ | 


(75)H2| 




RETRANSMISSIONS | 


(76)1131 




# RESPONSE TIMEOUTS 


(77)11U| 




# BCC ERRORS 


100)1151 




# RECV TIMEOUTS | 


101)ll6| 




f OVERRUNS | 


102)1171 




PREVIOUS RECOV ERROR | 


103)120| 




BUF 1 BYTES LEFT f 


10H)121| 




BUF 2 BYTES RIGHT | 


105)1221 




RECV MFW j 



6l(U8) 

62(1*9) 
63(50) 

6M5D 
65(52) 

66(53) 
67(5*0 
68(55) 
69(56) 
70(57) 
71(58) 
72(5l») 
73(60) 
7U(6l) 
75(62) 
76(63) 
77(6U) 
78(65) 
79(66) 
80(67) 
81(68) 
82(69) 



13-82 



CS DIT (CONT. ) 



I LINE 
(0123 


CONTROL MONITOR (LCM) | 
SECTION OF THE DIT j 

6 7 8 10 11 12 ) 


|RC|SE|RE|RE| 
|AK|AK|SP|SP| 
|CT|CT|TO|FG| 


|SD|RD|RD| |DW|SV|TE| j 
JWAJREJINJ |N |AB|XT| j 
|CK|PT|TR| |LD|RT| j j 


j USER REQUEST j 


| CURRENT STATE j 


I TRACE STATE j 


! MRJE BUF | 


I MRJE BUF 1 | 


| MRJE BUF 2 j 


I LCM BUFFER (8 words) [ 


i EDITOR SECTION 
j OF THE DIT j 
(DRIVER DEFINED) 


| PHYSICAL DRIVER | 

SECTION OF THE DIT 
| (DRIVER DEFINED) | 



LCMP(O) LCMPFLAGS 

LCMP(l) 

LCMP(2) 

LCMP(3) 

LCNP(U) 

LCMP(5) 

LCNP(6) 

ILCMP(7)-LCMP(1U) 
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CS DIT (COMT. ) 



CS DIT FIELDS AMD DEFINITIONS 



MASK and FLAG 
Words 13 and lU 



CMP" IN 
PWR-FL 
HD-ABT 
SF-ABT 
TO 

BF FZ 
ID FZ 
USER RQ 
LOC-TO 



Completion Interrupt 

Power Fail 

Hard Abort 

Soft Abort 

Timeout 

Buffer Frozen 

ID Frozen 

User Request 

Local Timeout 



COPTIONS 
Word 19 



AOPTIONS 
Word 20 



INH-TO 
INH-ID 
TRC-SP 
INH-CL 



INH-BF 
CON,- 10 



Inhibit Timeout 
Inhibit ID 
CS Trace 
Inhibit :CLINE 



Inhibit Buffering Override 
Concurrent 10 



DOPTIONS 
Word 21 



MISC 
Word 22 



REM-WT 

NO-RVI 

DSB-CT 

END-SEQN 

LD-GPH 

AS-BCC 

DB WK 

DB-TTD 

EX ITB 

MWF TYPE 

CHA-WR 

NUM-SYNCS 



CODE SN 
ABT-AK 
DUAL SP 
HALF SP 
XHSN MODE 
SPD-CH 



Delay Sequence Wait 

Poll Termination Sequence 

Disable Control Read 

Ending Sequence 

Leading Graphics 

Value of US ASCII BCC 

Disable WACK 

Disable TTD 

Expect ITB 

Message Format Word 

Chain Writes 

Number of Leading SYNCS 



Code Sensing 
Abort ACK 
Dual Speed 
Half Speed 
Transmission Mode 
Speed Changeable 
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CS DIT (COHT.) 



DST INTO 
Word 23 



ID PRES 



ID Present 



FLAGS 
Word 31 



REQ USD 
RECV ER 
TR COMP 
TR PDRV 
IN HNDL 
DIRT BF 
ID BITS 
ID FRZN 
ID ERR 
1ST IN 
2ND IN 
MSTA TR 
ABT LAT 
FIND ID 
PAD ADD 
AB POLL 



Request Used 

Recoverable Error 

Trace Out Completion 

Trace Out Physical Driver 

Interrupt Handler 

Dirty Buffer 

ID Frozen Bits 

ID Frozen 

ID MAM Error 

First Interrupt 

Second Interupt 

MMSTAT Trace 

Abort Later 

Find Station ID 

Pad Added 

Abort Poll 



STANDARD 
Word 5b 



(k6) 



TRC ERR 
TRC COM 
TRC FLH 
IN & PL 
DSR DL 



Trace Error Toggle 
Trace Complete 
Trace Flush 
Increment and Poll 
Date Set Ready Delay 



LCMFLAGS 
LCMP(O) 



RC AKCT 
SE AK CT 
RESP TO 
RESP FG 
SD WACK 
RD REFT 
RD INTR 
DWN LD 
SV ABRT 
TEXT 



Received ACK Counter 

Send ACK Counter 

Response Timeout 

Response Flag 

Send WACK 

Read Repeat 

Read Interrupt 

Download 

Save Abort 

Text 
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MULTIPOINT TERMINAL DEVICE INFORMATION TABLE 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

|0 |AC|RQ|0 |0 |PM|0 |IA|0 |0 | 0| STATE |0 DFLAG 

NEXT DITP |1 DLINK 

IOQP 1 2 DIOQP 

UNIT | LDEVNT |3 DLDEVT 

DLTP I k DDLTP 

ILTP 15 DILTP 

RESERVED |6 

RESERVED 1 7 

RT|LG| |8 DTIME 

GS|RE|CR|FC|MR|WP|RP|DR|UP|PS|RTR|TIM|BR|SSR|FLU|LP|9 DMISCT 

LG TT|WA|RJ|DW|DR|UR|0 | LDEVNL |10 DLDEVL 

DSTN of terminal buffer 111 DDSBUF 

Write limit Counter (12 DWLIM 

FORMATF | Reserved 1 13 DFRMAT 

Dit Pointer For Next Unit |lU DNEXT 

Pointer to next Dit with postponed write |15 DNWRT 

LF|DR|BM|AT|SM|WQ|DJST | STATIONINDIT |l6 DSTA 

FIRST WORD FOR ASCII WRITES (if par 1=1) |17 DFIRST 

ACTUAL BYTE COUNT FOR READS I 18 DBCNT 

READTINDEXF | LOGONTINDEXF |19 DTIND 
READTIME - 1ST WORD OF DOUBLE READTIMER READING |20 DRTMD 

2nd WORD OF DOUBLE READTIMER READING (start) |21 

MAXIMUM READ TIME IN SECONDS I 22 DRTMAX 
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MULTIPOINT TERMINAL DEVICE INFORMATION TABLE (cont) 

1 2 3 ^ 5 6 7 8 9 10 11 12 13 lU 15 
TERMINALTYPE | | SPEED 1 23 



LOGICAL/PHYSICAL WRITE COUNTER |2U 

HOLDS UNEDITED MODE CHARS, WHILE IN BREAK MODE | 25 



DSTN OF DATA SEGMENT HOLDING "HELLO" MESSAGE | 26 
BYTE COUNT FOR "HELLO MESSAGE" 1 27 



POINTER TO NEXT DIT IN WACK Q 
POINTER TO NEXT DIT IN REJECT Q 



CURRENT VERSION NO. OF IOMPTRMO (MODULE 1) 
ATTENCHAR | ENDCHAR 



128 

1 29 
130 
131 



DSTN OF SECONDARY TERMINAL BUFFER 1 32 

BYTE COUNT (READS), BUFFER LENGTH (WACK or reject | 33 

RESERVED I GROUPINDIT 1 3 1 * 



DTYPE 

DWCNT 

DBUNM 

DDSHEL 

DHBCNT 

DWACK 

DREJT 

DMOD 

DUNMD 

DDSB2 

DBCNT 

DGRP 
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MULTIPOINT TERMINAL DIT (CONT) 

DFLAG - Flags and SIODM state. 

.ACTIVE - SIODM is currently active servicing this device. 

.REQUEST - Service for this device was requested while SIODM 
was active. 

.PREMPT - Peenptive request flag. 

•IAK - Response has occured (interrupt acknowledge flag). 
.STATE - SIODM state. 

DLINK - SYSDB relative pointer to the DIT for the next device 
requesting service or this resource. 

DIOQP - SYSDB relative pointer to the DIT for the next device 
requesting service or this resource. 

DLDEVT - Logical device number and unit number. 

.LDEVNT - Logical device number of the multipoint terminal. 

.UNIT - Unit number representing terminal address (groun 
and device ID). \s*««F 

DDLTP - SYSDB relative pointer to Driver Linkage Table (DLT). 

DILTP - SYSDB relative pointer to dummy Interrupt Linkage Table 
(ILT) to satisfy SIODM requirements (no reaal ILT is 
associated with multipoint terminals). 

DTIME - Timer flags. 

.READTOF - Read timeout has occurred. 

.LOGONTOF - Log on timeout has occurred. 
DMISCT - Miscellaneous flags. 

•GSIN - Last character received from the terminal was the GS 
character . 

•READEROR - Read error has occurred. 

•CRITICAL - If set, IOMPTRM0 will not attempt to release extra 
data segments previously acquired by MPMON 



13-88 



MULTIPOINT TERMINAL DIT (CONT) 



•FILTERCRLFOK - Proper editing of input data with respect 
to CR and LF characters has already been 
made. 

.MARKED - This DITT has already been processed during 
construction of SUPLIST. 

.WPOSTP - Current write request has been postponed. 

.READPEND - Read request is pending against this terminal. 

.DATAREADY - Input data has been received and is ready in 
the terminal read buffer. 

.UP - Device has been initialized through the log on procedure 
or has been allocated. 

.PRESPACEF - Last write operation was with a prespace request. 
If the next write operation is with a post space 
request, output CR and LF before data. 

.READTIMERF - Read timing requested and not yet in progress. 

.TIMING - Current read request is being timed. 

.BRKOK - System break is enabled. 

.SSBRKOK - Subsystem break is enabled. 

.FLUSH - This flag i set whenever break has been detected and 
accepted. While it is set, writes are returned 
completed without any I/O being done. Reads are 
returned with an unusual condition status %173. It 
also holds off any further break service requests. It 
is reset with a function code 25 operation. 

.LASTPREMEPT - Last request was a preemptive request. 



DLDEVL 






. LOGONTYPE 


- 0: 


JOB 




1: 


SESSION 




2: 


DATA 



WACK - If set then WACK or EOT condition has been 
detected and the terminal was placed in the 
WACK queue. 
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MULTIPOINT TERMINAL DIT (CONT) 



. REJECT - If set then a terminal error has been detected 
and the terminal was placed in the REJECT queue. 

. DOWN - If set then this terminal was declared down 
through the console operator command or the 
configuration file. 

. DOWNREQ - If set then a request is pending to declare the 
terminal down. 

UPREQ - If set then a request is pending to declare the 
terminal up. 



.LDEVNL - Logical device number of the controller servicing the 
multipoint line. 

DDSBUF - Data segment number of the terminal read buffer. 

DWLIM - Write limit counter. 

DFORMAT 

.FORMATF - This field holds information about vertical format 
specification for writes obtained from PI parameter 
of the IOQ element or from the first data byte. 

DNEXT - SYSDB relative pointer to the DITT for the next terminal 
on the same line. 

DNWRITE - S7SDB relative pointer to the DITT for the next 
terminal with postponed write. 

DSTATION - Flags and station number. 

.LFLUSH - This flag is set to indicate that data for this 

terminal already scheduled to be written from the 
output buffer should not be physically sent to the 
terminal (break or subsystem break environment). 
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MULTIPOINT TERMINAL DIT (CONT) 



.DISCONREQ - Request to disconnect the terminal. 
.BREAKMODE - Terminal is in break mode. 

.ATTENTERM - Terminal is in attention mode. 

.SSBMODE - Terminal is in subsystem break mode. 

.WLQUEUE - A write request was forced to be queued by MPE 
I/O system. 

.DJSTATE - State of terminal straps D and J. 

- Initial state. 

1 - Straps D and J are open or will be open 

before the next write. 

2 - Undefined D and J setting. 

.STATIONINDIT - Station number assigned to this terminal by 
CS. 

DFIRST - Storage for first word for ASCII writes if vertical 
format is specified by first data byte. 

DBCNT - Actual byte count for reads. 

DTIND - Timer indexes. 

.READTINDEXF - Read timer index. 

.LOGONTINDEXF - Log on timer index. 

DRTIME (DRTIMED) - During a timed read, this is the reading of 

the timer at the initiation of the read. 
After a timed read is completed, the time in 
1/100 of a second is saved in DRTIME as a 
single word. If it is -1 then the time was 
greater than 32K. 

DRTMAX - When a read operation timeout is requested, this 
quantity represents the maximum time in seconds 
allowed for the read to be completed. 
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MULTIPOINT TERMINAL DIT (CONT) 



DTYPE - Terminal type and speed. 

.TERMINALTYPE - Configured terminal type. Multipoint terminal 
is type lU. 

.SPEED - Reserved field for configured terminal speed (not 
used for multipoint terminals). 

DWCNT - Logical/physical write counter. 

DBUNMODE - Holds unedited mode characters while in break mode. 

DDSHEL - DST number of data segment holding "HELLO" message (or 
backspaced data). 

DHBCNT - Byte count for "HELLO" message (or backspaced data). 



DWACK - Pointer to next DIT in HACK queue. 
DREJECT - Pointer to next DIT in REJECT queue. 

DM0D1VER - Current version number of the multipoint terminal 
driver (IOMPTRMO). 

DUNHODE - Unedited mode characters. 

.ATTENCHAR - Attention character. 

.ENDCHAR - End-of-character. (Effective as a control 

character is set to %137» otherwise not used). 

DDSBUF2 - Data segment number of secondary read buffer. 

DBCNT2 - Byte count for read if secondary read buffer is used 



DGROUP 

GROUPINDIT - Logical group number assigned to this terminal 
by CS. 
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MULTIPOINT SUPERVISOR DEVICE INFORMATION TABLE (DITS) 



1 2 3 *♦ 5 6 7 8 9 10 11 12 13 lU 15 

|0 |AC|RQ|0 |0 |PR|0 |IA|0 |0 |0 | STATE |0DFLAG 

NEXT DITP |1 DLINK 

IOQP |2 DIOQP 

UNIT | LDEVNS |3 DLDEVS 

DLTP |U DDLTP 

ILTP |5 DILTP 

RESERVED |6 

RESERVED |7 

WA|RJ| |8 DTIME 

MP|DU|DE|TO|TOR|TR|SN|SR|BH|MA|MU |GP |GD| GW |GR|CR |9 DMISCS 

RESERVED | LDEVNL |10 DLDEVL 

DIT POINTER FOR MP SUPERVISOR |11 DDITSP 

OFFSET TO TRACE BUFFER IN MPMON STACK 1 12 DTBOFF 

WRITE LIMIT CONSTANT |13 DWLCON 

DIT POINTER FOR FIRST UNIT |lU DNEXT 

POINTER TO FIRST DITT WITH POSTPONED WRITE |15 DNWRIT 

CURRENT VERSION NO. OF IOMPSO (MODULE 2) |l6 DMOD2V 

ADDRESS OF LINE READ BUFFER IN MPMON STACK 1 17 DINBA 

ADDRESS OF LINE WRITE BUFFER IN MPMON STACK |18 DOUTBA 

OUTPUT SPEED |19 DOSPD 
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MULTIPOINT SUPERVISOR DIT (CONT) 



1 2 3 k 5 6 7 8 9 10 11 12 13 lU 15 
INDEX OF HEAD ENTRY IN LINE WRITE BUFFER I 20 



INDEX OF TAIL ENTRY IN LINE WRITE BUFFER |21 

INDEX OF LAST AVAILABLE WORD IN LINE WRITE BUFFER |22 



TERMINAL TYPE |SP|DO|ID| SPEED 
CURRENT VERSION NO. OF MPMONCMD (Module 3) 



DSTN OF MPMON STACK 

1st WORD 



LINE SPEED 
DLSPEED 



LINE SPEED - 2nd WORD 
POINTER TO FIRST DIT IN WACK Q 



POINTER TO FIRST DIT IN REJECT Q 

WACKTINDEX I REJECTTINDEX 



CFCHARO 
CFCHAR2 



CFCHAR k 
CFCHAR6 
RO|UDR|FB|CD|FS| 



I 



CFCHAR1 
CFCHAR3 



CFCHAR5 
CFCHAR7 



123 
\2k 



125 
126 



DHEADI 

DTAILI 

DENDI 

DTYPE 

DMOD3V 

DMDSTN 



127 
128 



129 
130 



131 
132 



133 
|MM| UD|MO|35 



DWACK 

DREJ 

DWRTI 

DCF01 

DCF23 

DCF»45 

DCF67 
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MULTIPOINT SUPERVISOR DIT (CONT) 



DFLAG - 

DLINK - Same as for DITT 

DIOQP - 

DLDEVS - Logical device number and unit number. 

.LDEVHS - Logical device number of the Multipoint Supervisor. 

.UNIT - Unit number (always 0). 

DDLTP - Same as for DITT 
DILTP 

DTIME - , . 

.WACKTO If set, then WACK timeout has expired 
.REJECTIO If set, then REJECT timeout expired. 

DMISCS - Miscellaneous flags. 

.MPOK - If set, then IOMPSO is allowed to process I/O requests 
against the Multipoint Supervisor. 

.DEBUGOH - If set, then DEBUG will be called from MPMOK. This 
flag is set through the MPLINE command. 

.TRACEON - Trace facility is enabled. 

.TRACEOFFREQ - Trace facility is to be disabled. 

.TRACEONREQ - Trace facility is to be enabled. 

.SHUTHOW - Request to shut the line immediately. 

.SHUTREQ - Request to shut line after all terminals are 
released 
Hew sessions are not allowed to be initiated. 

.BUSYHEAD - The line write buffer contains data to be written 
to a terminal on the line. 
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MULTIPOINT SUPERVISOR DIT (CONT) 

.MPONACT - MPMON process is active. 

•KPMONUP - MPMON process has been created and activated. 

.GENWPOSTP - A write request for one or more terminals on the 
line has been postponed. 

.GENDISCON - Request to disconnect the line. 

.GENWACK - If set then there is a terminal in the WACK queue. 

. GENRE JECT - If set then there is a terminal in the REJECT 
queue . 

.COMPLREQ - Request to complete dummy read pending against the 
Multipoint Supervisor. 

DLDEVL 

.LDEVNL - Logical device number of the controller servicing the 
multipoint line. 

DDITSP - SYSDB relative pointer to the DIT for the Multipoint 
Supervisor (DITS). 

DTBUFOFFS - Offset to the trace buffer in MPMON stack. 
DWLCON - Write limit constant. 

DNEXT - SYSDB relative pointer to the DITT for the first terminal 
on the line (the terminal with the lowest logical device 
number) . 

DNWRITE - SYSDB relative pointer to the DITT for the first 
terminal with postpond write. 

DM0D2VER - Current version number of the Multipoint Supervisor 
driver (IOMPSO). 

DINBUFA - Address of the line read buffer in MPMON stack. 

DOUTBUFA - Address of the line write buffer in MPMON stack. 

DOSPEED - Output speed. 

DHEADI - Index of head entry in the line write buffer. 

DTAILI - Index of tail entry in the line write buffer. 
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MULTIPOINT SUPERVISOR DIT (CONT) 



DENDI - Index of last available word in the line write buffer. 

DTYPE 

.TERMIKALTYPE - Configured terminal type. Multipoint 
Supervisor is type lU (same type as 
multipoint terminals ) . 

.SUPER - This device is a Multipoint Supervisor. 

.DITSOK - DIT's for the multipoint terminals and the 

Multipoint Supervisor on this line have been 
rearranged and their format corresponds to 
standard DIT format for SIO devices. 

.SPEED - Reserved field for configured terminal speed 
(not used for Multipoint Supervisor). 

.INITDONE - If set then all multipoint terminals belonging to 
the same multipoint supervisor have been linked. 

DM0D3VER - Current version number of the MPLINE command 
processor (MPMONCMD) . 

DMONDSTN - Data segment number of MPMON stack. 

DLSPEED (DLSPEEDD) - If not equal to 0, then the line is opened 

with speed specified in this double word. 

DWACK - Pointer to the first terminal DIT in the WACK queue. 

DREJECT - Pointer to the first terminal DIT in the REJECT queue. 

DWRT1 

.WACKTINDEX - WACK timer index. 
.REJECTTINDEX - REJECT timer index. 

DCF01 through DCF67 - String of characters representing: 

a) the name of the configuration file, or 

b) the logical device number of the terminal, or 

c) terminal group and device ID. 

DCOHFL 

.REOPEN - If set then a request for line reopening has been 
made . 

.UPDOWNREQ - If set then a request to set the terminal UP or 
DOWN has been made. 

.FORCE' SHUT - If set then a request has been made to shut the 
line immediately. 
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MULTIPOINT SUPERVISOR DIT (CONT. ) 



.UP 'DOWN - If true then the terminal is to be set UP else the 
terminal is to be set DOWN. This flag is used in 
conjunction with .UPDOWNREQ flag. 

.MSGOFF - If set then certain MTS messages are not displayed on 
the operator console. 
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INP DIT 



DITO 





1 2 3 *» 5 6 7 8 9 10 11 12 13 lU 15 




+ 

o 1 


| AC | RQ | TI | 0|PR|IO|IN|SM|HAMSTATE| 


IOSTATEl 


DFLAG 


1 1 


POINTER TO NEXT DIT 1 


DLINK 


2 I 


INPUT REQUEST QUEUE 1 


DIOQP 


3 1 


| LOGICAL DEVICE 


NUMBER | 


DLDEV 


U 1 


DRIVER LINKAGE TABLE POINTER 1 


DDLTP 


5 1 


INTERRUPT LINKAGE TABLE POINTER I 


DILTP 


6 1 


INTERRUPT STATUS 1 


DSTATUS 


7 1 


SOFTWARE TIMER REQUEST INDEX 1 


DTRLX 


8 1 


TO| 1 


DTIME 


9 1 


READT QUEUE HEAD POINTER 


READYQ 


10 


READY QUEUE TAIL POINTER 


READYQTL 


11 


ACTIVE QUEUE HEAD POINTER 


ACTIVEQ 


12 


ACTIVE QUEUE TAIL POINTER 


ACTIVEQTL 


13 


WAITED QUEUE HEAD POINTER 


WAITEDQ 


1U 


WAITED QUEUE TAIL POINTER 




15 


|EO|WPjTR| iPFSTATE|UF|PRiNR|SD| OS | 




|AB 


DSTATE 


16 


| RESERVED | MESSAGE TO INP TYPE 


| DOUTMSG 


17 


| REQUEST IDENTIFIER (glOQP) 


| DOUTID 


18 


| PARAMETER 1 (QMISC) 


| DOUTP1 


19 


| OUT COUNT 


| DOUTCNT 


20 


| PARAMETER 2 (QPAR2) 


| DOUTP2 


21 


| SEND DIALOGUE COUNTER 


| DSEND 


22 


| RECEIVE DIALOGUE COUNTER 






| DRECV 


23 


| "MESSAGE SENT" EOT BUFFER 


| DECT 
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INP DIT (cont) 






2U 


RESERVED | MESSAGE FROM 


INP TYPE | 


DINMSG 


25 


REQUEST IDENTIFIER (6IOQP) 


I DINID 


26 


ERROR CODE |LS| 


I CSTATUS 


I DRSTATUS 


27 


1 IN COUNT 


I DINCNT 


28 


TRANSMISSION LOG 


I DXLOG 


29 


PARAMETER 


I DINPARM 


30 


TRACE READY REQUESTS COUNT 


DTRCNT 


31 


EXTERNAL TRACE EXTRA DATA SEGMENT NUMBER 


DDSTN 


32 


RESERVED | OUT MSG TYPE AT ERROR 


DERROR 


33 


REQUEST IDENTIFIER (glOQP) 




3U 


PARAMETER 1 (QMISC) 




35 


OUT COUNT 




36 


PARAMETER 2 (QPAR2) 




37 


LAST CS ERROR CODE 


DCSERR 


38 


IOQP POINTER AT TIME OF ERROR 


DSAVE 


39 1 


TPiPHY DRVR VERSN # ! LOGICAL DRIVER VERSION # 1 


DVERSION 


1*0 ! 




AT ERROR I 




RESERVED ! IN MSG TYPE 


DERRORI 


1»1 ! 


REQUEST IDENTIFIER (6IOQP) 


1 




U2 ! 


ERROR CODE !LS1 


! STATUS 1 




U3 I 


IN COUNT 


] 




kk . 


TRANSMISSION LOG 


] 




»»5 1 


PARAMETER 


1 




U6 ! 


DRIVER ERROR CODE 


j 


DDRVRERR 


U7 I 


MONITOR ERROR CODE 


i 


DMNTRERR 
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INP DIT (cont) 



U8 I HARDWARE ERROR STATUS ! SIO PROGRAM INDEX ! DSERR 

U9 i TOOTH PICK HARDWARE ERROR STATUS ! DTP 'ERROR 

50 I ADDITIONAL TOOTHPICK HARDWARE ERROR STATUS | 

51 J DRIVER TRACE READ IOQ POINTER ! DTR'IOQP 
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INP DIT (cont) 



DFLAG - Flags, IOSTATE and MAMSTATE 

ACTIVE - If set, the Driver is active servicing this device 

REQUEST - If set, service for this device was requested while 
the Driver was active. The Driver is run again to 
insure servicing of the condition which caused 
REQUEST to be set. 

DO 'TIMING - If set, the hardware and software timers are started 
in the normal manner when performing an operation. 
If clear, no timing is done. 

SIOPREEMPT- Preemptive request queued by ATTACHIO. Not used by 
this Driver. 



IOPROG - If set, an I/O program is in progress. Set by 
STARTIO and cleared by GIP. Not used by the 
Driver. 

IAK - Interrupt Acknowledge If set, an interrupt has 
occurred or a software timeout has completed. 

SIMULATOR - If set, all I/O is to be simulated. The Driver will 
set flags in the DRT instead of calling STARTIO. 






Memory Manager State 

- Null, no Memory Management requests or condition 
Not used 

Data segment associated with the first request in 
the Active Queue is being made present and frozen. 
Data segment associated with the first request in 
the Active Queue is frozen in memory. 
Data segment associated with the second re- 
quest in the Active Queue is being made pre- 
sent and frozen. Implies the data segment 
associated with the first request is frozen. 
Data segments associated with the first and 
second requests on the Active Queue are frozen 
in memory. 

6 - Not used 

7 - Not used 



1 
2 

3 
k 



5 - 
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IHP DIT (cont) 



IOSTATE - Current I/O program operation being performed 

- Inactive No I/O in progress 

1 - Idle Read The Idle Read I/O program has been 

started. 

2 - Sending message An I/O program which sends a 

message without data and then goes to the Idle 
Read section of the I/O program has been started. 

3 - Sending data An I/O program which sends a 

message and data and then goes to the Idle Read 
section has been started. 
U - Send message and interrupt An I/O program 

which sends a message without data then interrupts 
and halts when the message is sent has been 
started. 

5 - Send data and interrupt An I/O program which 

sends a message with data then interrupts and 
halts has been started. 

6 - Receive data An I/O program which sends a 

message and receives data then interrupts and 
halts has been started. 

7 - Do not start I/O Used to hold off requesting 

any I/O activity during a power on reset or 
when an error occurs. 

DLIHK - Link word for the linked list of devices waiting to be 
serviced by the I/O process associated with this device 

DIOQP - System DB relative pointer to the first element in the 
requests to be processed list for this device The re- 
quests are queued to this list by ATTACHIO but in pro- 
cessing, the are moved to other queues depending of the 
state of the request The Driver always attempts to 
keep this list empty. 

DLDEV - Logical Device Number of this device 

DDLTP - System DB relative pointer to the Driver Linkage Table. (DLT) 

DILTP - System DB relative pointer to the Interrupt Linkage Table. (ILT) 



DSTATUS - Controller hardware status Set by GIP on interrupt and 
the Physical Driver during certain service operations 
See INP ERS for description. For the Toothpick ver- 
sion, this word contains the software timeout flags 
as described for the word DTIME below. 
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INP DIT (CONT) 



DTRLX - Timer request index for software timeouts as returned by 
the HFE procedure TIMEREQ 



DTIME - Timed out flags and type 3 driver process PCB Number 
TIMED - If set, a software timeout has completed 



READYQ - System DB relative pointer to the IOQ for the first request 
in the Ready Queue. If zero, the Ready Queue is empty. 

READYQTL - System DB relative pointer to the last IOQ in the 
Ready Queue. When the queue is empty, this word 
points to the word preceding the queue head pointer 

in the DIT. 



ACTIVEQ - System DB relative pointer to the IOQ for the first 

request in the Active Queue. If zero, the Active Queue 
is empty. 



ACTIVEQTL - System DB relative pointer to the last IOQ in the 
Active Queue. When the queue is empty, this word 
points to the word preceding then queue head pointer 
in the DIT. 



WAITEDQ - System DB relative pointer to the IOQ for the first 

request in the Waited Queue. If zero, the Waited Queue 
is empty. 



WAITEDQTL - System DB relative pointer to the last IOQ in the 
Waited Queue. When the queue is empty, this word 
points to the word preceding then queue head pointer 
in the DIT. 



DSTATE - Driver state and control flags 

ERRORONLY - If set, the Driver trace record is to be returned to 
the Trace Process only when an error occurs. 

WRAP - If set, the Driver will overlay the oldest trace 
entry when a trace record overflow occurs. If 
clear, entries are lost when an overflow occurs. 

TRACEOM - If set the Driver trace facility is enabled and the 
Driver generates trace entries for most of its local 
subroutine calls. 
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INP DIT (CONT) 



PFSTATE - Power failure recovery state 

- Mo power failure recovery in progress 

1 - Powerfailure detected on the mainframe before 

INP indication. Check for completion of any 
pending I/O and then wait in PFSTATE 2 for INP 
to pfail. 

2 - Power failure detected on the Mainframe before 

INP has indicated a power failure. Wait for 
INP to indicate a power failure. 

3 - Power failure indicated by INP before being 

informed by the Mainframe power failure rou- 
tines. Wait for the Mainframe power failed re- 
quest . 
U - Power failure indicated both on the Mainframe 
and by INP. Power failure recovery may be star- 
ted. 

5 - Send Redo The Mainframe receive count was less 

than INP's send count so the dialogue must be 
restarted. The Driver is sending the Redo mes- 
sage. 

6 - Send Ignore The Mainframe send count was 

greater than INP's receive count so any part of 
a dialogue so far received is to be ignored and 
the entire dialogue will retransmitted. The 
Driver is sending Ignore message. 

7 - Recovered. The Mainframe and INP dialogue 

counters agree or mainframe not sending, so no 
recovery is necessary. The Driver is sending 
the recovered message informing INP to go back 
to its normal mode. 

UNFRZ - If set, the source data segment is to be unfrozen 
when the data has been transmitted to the INP. If 
clear, the source data segment remains frozen until 
a reuquest complete indication is returned by the 
INP. 

PASSREADS - If set, then read requests are to be passed around 
other requests which have been impeded because no 
buffers are available on the INP. 

NOTRDYWAIT- If set, then a request has been impeded because no 
buffers were available on the INP. 

SENDING - If set, an I/O program which send sends a message, 

with or without associated data has been started but 
not completed. 
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INP DIT (COHT) 



OPENSTAIE - Operational state of the Driver and INP 

- Hot opened or closed 

1 - In ROM The device has been opened but the RAH 

Operating System has not been entered 

2 - Crashed Some catastrophic error has occured 

3 '- In RAH. The device has been opened, down 

loaded and is in the RAH Operating System. 



ABORT - If set one or more requests have been aborted but 
the abort was not done because the aborted request 
was in the process of doing a Memory Management 
function or I/O when when request to abort was pro- 
cessed. The actual abort will take place when the 
Memory Management function completes. 



The following five words hold the message block which is sent to 
INP when the Physical Driver is called to send a message with or 
without associated data. The Logical Driver sets the message 
contents into this area and calls the Physical Driver to send the 
message. 



DOUTMSG - Message type code for messages sent to INP 

DOUTID - Request identifier associated with the message being 
sent. 

D00TP1 - Parameter one of the message being sent to INP 

DOUTCNT - Count parameter of the message being sent to INP 

D0UTP2 - Parameter two of the message being sent to INP 



DSEND - Messages sent counter. This word contains the number of 
messages sent since the RAM Operating System was entered. 
It is used for power failure recovery. 



DRECV - Messages received counter. This word contains the number 
of messages received from INP since the RAM Operating 
System was entered. It is used for power failure re- 
covery . 
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INP DIT (CONT) 



DEOT - End of dialogue flag. When a message has been sent and 
the EOT indicating IMP has received the message is trans- 
mitted, it is received into this word. This flag is used 
to indicate to the Logical Driver that a transmission has 
been completed and that the Physical Driver should be 
called to check the completion status and update the 
IOSTATE. 

The following six words are the data area into which messages 
from IMP are received. The Physical Driver constructs I/O pro- 
grams which reference this area. 



DIMMSG - Message type code of message from IMP 

DIMID - Request Identifier associated with message from INP 

DRSTATUS - Request Completion status 

DIMCNT - Number of bytes of data to be received associated with 
the completion of a request which results in data be- 
ing sent from IMP. 

DXLOG - Transmission log to be returned when the request 
identified by DIMID is completed. 

DINPARM - Parameter associated with the completion of this 

request. This word is return in the X register by 
IOSTATUSX. 



DTRCMT - Trace ready pending count. This word contains the 

number of Trace Ready messages recieved but not satis- 
fied by Trace Read requests. 



DDSTM - If not zero then internal Driver extra data segment 

tracing is enabled and this is the data segment number 
into which the trace entries are to be set. 



DERROR - Driver Error block. The following sixteen words are 

used to store information describing the current opera- 
tions being performed when a catastrophic Driver error 
occurred. A catastrophic error occurres on illogical 
Driver control data, MPE errors or when IMP does not 
respond in an expected manner. The first five word 
block is used to hold the current or last message trans- 
mitted to INP when a catastrophic error condition was 
detected. It contains the data in the same format as 
message to IMP block. 



13-107 



IHP DIT (COiT) 



iXSERR - CS Error Code associated with a catastrophic Driver 
error 

DSAVE - Request Identifier of the request being processed when a 
catastrophic Driver error was detected 

DVERSIOH - Version numbers of the Physical and Logical Drivers 

TP - If set, the Physical Driver is for the Toothpick 
System 

PVERSIOH - Physical Driver version number 

LVERSIOH - Logical Driver version number 



DERRORl - The six word block beginning here is used to hold the 
last message received from IMP before a catastrophic 
Driver error was detected. It contains the data in the 
same format as the message from IHP block. 

DDRVRERR - Holds the code specifying the catastrophic error 

detected by the P hysi cal Driver. See ERRORS under the 
PHYSICAL DRIVER IMTSRMAL SPECIFICATIONS for the def ~ 
inition. 



DMHTRERR - Holds the code specifying the catastrophic error 

detected by the Logical Driver. See ERRORS under the 
LOGICAL DRIVER IHTERHAL SPECIFICATIONS for the def- 
inition. 



DSERR - Hardware Controller status when a catastrophic Driver 
error was detected. 

HSTATUS - Left byte of the DSTATUS word at time of error 

SIOPX - SIO program area relative index to th* last order 

executed or current order being executed at time of 
error. 
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INP DIT (CONT) 



DTP' ERROR - Toothpick hardware error status. To be defined. 



DTR'IOQP - If not zero then an IOQP pointer to the Trace Read 

request which is supplying the locked and frozen buf- 
fer into which the Driver places trace entries to gen- 
erate a trace record. 



DLOGX - Driver local trace buffer index. This is the index 

relative to the Driver local trace buffer to place the 
next trace entry. 

DLOGBUF - Driver local trace buffer. This buffer extends from 
here to the end of the DIT. 
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DISC REQUEST TABLE AND DISC REQUESTS 



Requests for disc transfers are effected by acquiring an entry from the Dis 
Request Table (DISCREQTAB) , filling the proper information, and calling the 
DISCQMANAGER to link the request into the device's doubly linked request qu 
The head and tail of a device's request queue are contained in the 
devices 's DIT. 



DISCREQTAB 



+ >+ 



„___+ 



j DIT | 



— + 



+ — > 



Device ' s 

Current 

Request 



First 

Request 

in Queue 



Next 

Request 
in Queue 



Last 

Request 

in Queue 



<> + 



<> + 



<> — -- 



+ 
I 
I 
I 
-+ 
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DISC REQUEST TABLE 

DISCREQTAB DST ENTRY* = 56 (%7G) 
DISCREQTAB PRT = %1031 



DISCREQTABOO 
DISCREQTABOl 
DISCREQTAB02 
DISCREQTAB03 
DISCREQTABOU 
DISCREQTAB05 
DISCREQTAB06 
DISCREQTAB07 
DISCREQTAB08 
DISCREQTAB09 
DISCREQTABIO 



DISC REQUEST TABLE ENTRY FORMAT 
1 2 3 ** 5 6 7 8 9 10 11 12 13 I s * 15 



-■ — I — I — I — I — I — I- 



TOTAL ENTRIES ! PRIMARY ENTRIES 
IMPEDED PROCESS PCB | ENTRY SIZE (%20) 



TABLE INDEX OF HEAD OF AVAILABLE ENTRY LIST 
TABLE INDEX OF TAIL OF AVAILABLE ENTRY LIST 



MAX ENTRIES IN USE | CURRENT ENTRIES IN USE 
OVERFLOWS 



TOTAL REQUESTS 



SYSBASE INDEX OF BEAD OF DISABLED REQ Q 



SYSBASE INDEX OF TAIL OF DISABLED REQ Q 
/////////////////////////////////////////////// 



DISCREQTAB15!/////////////////////////////////////////////// 
I 



DISCQHEAD 
DISCQTAIL 
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DISC REQUEST ELEMENT FORMAT 



Word 00 



Word 01 
Word 02 
Word 03 
Word 0U 

Word 05 

Word 06 
Word 07 
Word 08 
Word 09 
Word 10 
Word 11 
Word 12 
Word 13 
Word ll» 
Word 15 



0123U5678910 


11 12 13 lU 


A |M |D |S |I |B |C |D |M |Q |S 


IP |C |D |D | 


B |M |I |B |0 |K |0 |A |M |U |I 


IF |U |I |I | 


|R |A |U |W |D |M |T |E |E |0 


|A |R |S |S | 


R |E |G |F |A | |P |A |R |U |F 


U IR |A |A | 


T IQ 1 1 IK | | |F |R |E |A 


|L IE |B |T | 


1 1 1 IE | | | | | |I 


1 IQ 1 1 1 


1 1 1 1 1 1 1 1 1 |L 


1 1 1 1 1 



REQUEST URGENCY CLASS 
UNIT # I LDEV # 

MISCELLANEOUS 
S| DST (IF PROCESS DISC I/O) 
BANE (IF SEGMENT TRANSFER) 
OFFSET INTO DATA SEG (IF PROCESS DISC I/O) 
ADDRESS IN BANK (IF SEGMENT TRANSFER) 

I FUNCTION 

COUNT/XLOG/CONTROL RETURNS 

PI (HODA IF SEGMENT TRANSFER 

P2 (LODA IF SEGMENT TRANSFER 

PCBN I QUALIFIER | STATUS 

SYSBASE RELATIVE INDEX OF PREV REQUEST IN QUEUE 

SYSBASE RELATIVE INDEX OF NEXT REQUEST IN QUEUE 

SEGIDENTIFIER (IF SEG TRANSFER) 
DISPLACEMENT OF READ OR WRITE FROM SEG BASE (MM) 



I 



IlllllllllllllllllllllUlllinililllUIIIIIIIII 

IliUIIIIUIUIIIIIIIIIIIIIIIIIIIIIIUIIIIIilll 

minimi 1 ii mi 111 nun 11 1 111 limn ami! 

IlllltlllllillillllllllllllUllllllllllllllllll 



URGCLASS 

LDEVN 

MISC 

DSTN 
S=STACK 

ADDR 

FUNC 

XFERCNT 

PARI 

PAR2 

STAT 

PREVREQP 

NEXTREQP 
SEGIDENT 
SEGDISP 

AUXREQFLAGS 



Note: Upon return to free list, word (#1) becomes index of next EE 
free entry. 
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Word 


- QFLAG - Reqi 


Bit 


.ABORT 


Bit 1 


.MMREQ 


Bit 2 


.DIAG 


Bit 3 


.SBUF 


Bit U 


.IOWAKE 


Bit 5 


.BLOCKED 


Bit 6 


.COMPLETED 



Request has been aborted externally. 

Request is for a segment transfer. 

Diagnostic request (not used) . 

System Buffer. Target is a system buffer 
whose index is relative to the start of 
the SBUF table. 

Wake caller on completion of request. 

Blocked I/O. Caller is waited in ATTACHIO until 
request is completed. 

Request has been completed and caller woken if 
he had specified. 



Data segment has been made present and is 
frozen. 

HAM error on data segment make present. 

.PREQQUEUED Request is queued into disc's req queue 

Start SIO failure in GIP. 

The I/O has been aborted because of a powerfail. 

Request is device's current request. 

Request is disabled. 

Attempted to disable this request. 

A message request reply has completed. 

Word 2 - QLDEV.QLDEVN - Logical Device Number 
Word 3 - QMISC - Device dependent. 

Word U 

QDSTK - If SYSBUFRs is clear then this is the DST number of the target 
data segment. If bit is set then buffer address is a DB offset 
value instead of segment relative offset (implemented for 
NOWAIT 10 and NOBUFF). 

Word 5 

QADDR - Offset in data segment or sys buff table to target data buffer. 

Word 6 

QFUNC.FUNC - Function code and qualifiers as specified by driver. 



Bit 7 


.DATAFRZH 


Bit 8 


.MAMERRORD 


Bit 9 


.PREQQUEUE 


Bit 10 


.SFAIL 


Bit 11 


.PFAIL 


Bit .12 


.CURREQ 


Bit 13 


.DISABLED 


Bit lU 


.DISATMPT 


Bit 15 


.MSGDONE 
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Word 7 

QXFERCNT-On initiation specifies the word count if positive or byte 

count if negative. At completion of the request this location 
contains the actual transmission count in the same units as the 
call. Certain control requests return data through this 
location. 
Word 8 

QPAR1 - Parameter one, defined by driver 
Word 9 

QPAR2 - Parameter two, defined by driver 

QMISC - Miscellaneous request dependent storage available to driver. 
Word 10 
QSTAT.PCBN - PCB Number of process which made this request. Zero if 

not associated with any process and IOQ is to be returned 
by the system. 
.QUALIFIER - A code which further defies or qualifies the 

general status. Defined by driver. 
.STATUS - General Status. Indicates current and result state of 
the request according to the following codes. 

- not started or awaiting completion. 

1 - successful completion. 

2 - end of file detected. 

3 - unusual condition. 

*i - irrecoverable error. 

NOTE: See I/O System Status Returns. 
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IOQ TABLE LAYOUT 



DST %13 



TOTAL # 



PRIMARY # 



IMPEDED | ENTRY SIZE 
PROCESS PCBJ 



HEAD INDEX 
TAIL INDEX 



MAXIMUM OF | CURRENT 
IN USE J IN USE 



OVERFLOWS 



TOTAL REQUESTS 



INDEX OF 5 



ENTRY 1 



ENTRY 2 



INDEX OF 1 



ENTRY 3 



TSIZE 
THEAD 
TTAIL 
TUSE 

TOVRFL 

TRQSTS 
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IOQ (COHT.) 



Indeterminate 



ENTRY U 
(IN USE) 



INDEX OF 2 



ENTRY 5 



<--- 
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I/O QUEUE ELEMENT (IOQ) 

1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 

| REQUEST DEPENDENT FLAGS 
01 

I— 

1| IOQ POINTER 

I—— 

2| UNIT # | QLDEVN 

I 

3| MISCELLANEOUS 

I 

1(|S | DATA SEGMENT DST NUMBER 

I 

I - 

I 
51 ADDRESS 

I " 

6 1 I FUNCTION 

I " - 

7| COUNT/XLOG/CONTROL RETURNS 

I 

8| PI 

I 

91 P2 

I 

10| PCBN | QUALIFIER | STATUS 



QFLAG 

QLINK 

QLDEV 

QMISC 

QDSTN S(Word U(0:l) 
Stackflag If set 
QADDR is DB rel. 

QADDR 

QFUNC 

QWBCT 

QPAWL 

QPAR2 

QSTAT 



QFLAG - 
Bit 


Request depex 
.ABORT 


Bit 1 


.SPECIAL 


Bit 2 


.DIAG 


Bit 3 


.SBUF 


Bit k 


.IOWAKE 


Bit 5 


.BLOCKED 


Bit 6 


. COMPLETED 



Request has been aborted externally . 

Special handling is to be applied to this 
request. For disc, indicates a memory 
management request. 

Diagnostic request (not used). 

System Buffer. Target is a system buffer 
whose index is relative to the start of 
the SBUF table. 

Wake caller on completion of request. 

Blocked I/O. Caller is waited in ATTACHIO until 
request is completed. 

Request has been completed and caller woken if 
he had specified. 
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Bit 7 


.DATAFRZN 


Bit 8 


.MAMERRORD 


Bit 9 


.PREQ 



I/O QUEUE ELEMENT (CONT. ) 



Data segment has been made present and is 
frozen. 

HAM error on data segment make present. 

This request has been started but was preempted 
by a MAM request. 

Bit 10 .SFAIL Start SIO failure in GIP. 

Bit 11 .PFAIL The I/O has been aborted because of a powerfail. 

Bitsl2-13 .PREMPT Premptive type code: 1-soft, 2-hard. 

Bit 15 .MSGDONE A message request reply has completed. 
QLINK - SYSDB relative pointer to next IOQ element. Points to first 

word of element. 
QLDEV.QLDEVN - Logical Device Number 
QMISC -Device dependent. 

OPSIN - If STSBUFR8 is clear then this is the DST number of the target 
data segment. If bit is set then buffer address is a DB offset 
value instead of segment relative offset (implemented for 
NOWAIT 10 and NOBUFP). 
QADDR - Offset in data segment or sys buff table to target data buffer. 
QFUNC.FUNC - Function code and qualifiers as specified by driver. 
QWBCT - On initiation specifies the word count if positive or byte 

count if negative. At completion of the request this location 
contains the actual transmission count in the same units as the 
call. Certain control requests return data through this 
location. 
QPAR1 - Parameter one, defined by driver 
QPAR2 - Parameter two, defined by driver 

QMISC - Miscellaneous request dependent storage available to driver. 
QSTAT.PCBN - PCB Number of process which made this request. Zero if 

not associated with any process and IOQ is to be returned 
by the system. 
.QUALIFIER - A code which further defies or qualifies the 

general status. Defined "by driver. 
.STATUS - General Status. Indicates current and result state of 
the request according to the following codes. 

- not started or awaiting completion. 

1 - successful completion. 

2 - end of file detected. 

3 - unusual condition. 

M - irrecoverable error. 
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I/O SYSTEM STATUS RETURNS 

STATUS % 



PENDING 



1 - WAITING FOR COMPLETION 10 

2 - DOING ERROR RECOVERY 20 

3 - NOT READY WAIT 30 
U - NO WRITE RING WAIT **0 
5 - NEW PAPER TAPE WAIT 50 



1 - SUCCESSFUL 



- NORMAL 1 

1 - READ TERMINATED WITH SPECIAL CHARACTER 11 

2 - TAPE RETRY FOR SUCCESS RE QUIR ED 21 

3 - LOW TAPE OR END OF TAPE AFTER WRITE 31 



END OF FILE 

1 - PHYSICAL END OF FILE 12 

2 - DATA 22 

3 - END OF DATA 32 
k - HELLO **2 

5 - BYE 52 

6 - JOB 62 

7 - END OF JOB 72 



3 - UNUSUAL CONDITION 

1 - TERMINAL PARITY ERROR 13 

2 - TERMINAL READ TIMED OUT 23 
3-1/0 ABORTED EXTERNALLY 33 
U - DATA LOST *»3 

5 - DATA SET NOT READY OR DISCONNECT 53 

OR UNIT NOT ON LINE 

6 - ABORTED BECAUSE OF POWER FAIL 63 

7 - BOT AND BSR, BSF REQUEST 73 

10 - TAPE RUNAWAY 103 

11 - EOT AND WRITE REQUEST 113 

12 - NO WRITE RING AFTER REQUEST TO OPERATOR 123 

13 - END OF TAPE (PAPER TAPE LOW) 133 
lU - PLOTTER LIMIT SWITCH REACHED 1^3 

15 - ENABLE SUBSYSTEM BREAK AND NO CONTROL Y PIN 153 

16 - READ TIME RETURNED OVERFLOW 163 

17 - BREAK STOPPED READ 173 
20 - WRITE AND NO CARD IN WAIT STATION 203 
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I/O SYSTEM STATUS RETURNS (CONT.) 



It - IRRECOVERABLE ERROR 

- INVALID REQUEST 1, 

1 - TRANSMISSION j^ 
2-1/0 TIME OUT 2k 
3 - TIMING ERROR 3 J, 
It - SIO FAILURE Uk 

5 - UNIT FAILURE 5 1» 

6 - INVALID DISC ADDRESS Sk 

7 - TAPE PARITY ERROR 7I1 

11 - PAPER TAPE TAPE ERROR uk 

12 - SYSTEM ERROR 12b 

13 - INVALID SBUF INDEX 13!* 
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TERMINAL IOQ ELEMENT 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
| REQUEST DEPENDENT FLAGS 

or 

I " - 

1| NEXT IOQP 
I 

2 1 UNIT # | LOGICAL DEVICE NUMB. 

I 

|FL| IREADSTOP | REQUEST STATE 
I 

U|SF| DATA SEGMENT NUMBER 

I 

51 TARGET ADDRESS OFFSET 
I - 

6| | FUNCTION CODE 

I 

71 COUNT/XLOG/CONTROL RETURNS 

I 

%10| PARAMETER 1 (FUNCTION DEPENDENT) 

I 

%11| PARAMETER 2 (FUNCTION DEPENDENT) 

I - 

| I QUALIFYING | GENERAL 
%12| PCBN j STATUS j STATUS 
I 

BITO ABORT 

BIT1 SPECIAL 

BIT2 DIAGN OSTIC 

BIT3 SYS BUFFER 

BITU 10 WAKE 

BIT5 BLOCKED 

BIT6 COMPLETED 

BIT7 DATA FREEZE 

BIT8 MAM ERROR 

BIT9 

BITLO-12 READ ERRORS 

BIT13-15 RPLEVEL 



QFLAG 
QLINK 
QLDEV 
QMISC 
QDSTN 
QADDR 
QFUNC 
QWBCT 
QPAR1 
QPAR2 

QSTAT 
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TERMINAL IOQ FIELDS AMD DEFINITIONS 



QFLAG - Flags and request state. 



ABORT Abort this request and return an error indication to 
the caller. 

SPECIAL Special handling is to be applied to this request. Has 
no meaning for terminal requests. 

DIAGNOSTIC This is a request from a diagnostic subsystem. Not used 
by terminal system. 

S7SBUFRS Target is an index relative to the SBUF table of the 
data buffer. 

IOWAKE Wake caller on completion of request. 

BLOCKED Blocked I/O. The caller is waited in ATTACHIO until the 
request is completed. Implies wake. 

COMPLETED Request has been completed and caller woken if requested. 

DATAFRZN If set then the data segment has been frozen in memory. 
Set by MAM when a MAKEPRESENT request is successfully 

MAMERRD An error has occurred in trying to make the target data 
segment present and freeze it in core. 

READERRORS This field contains a code specifying the resulting 
status on a read termination. 

- no error 

1 - read terminated on special read termination 

character 

2 - read completed because break was enabled and 

detected and allowed. 

3 - read data lost because of no TBUFS available, 

PTAPE swing buffer write not completed in time 
or term*=ll and char following DC2 was not a CR. 
U - character lost because interrupt not service 
before next character was input 

5 - read parity error occurred and parity checking 

enabled 

6 - read timed out 

7 - block mode read timed out 
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TERMINAL IOQ (COHT. ) 



RPLEVEL Request preempt level. If the preempt type of the request 
was zero then this is the value of TMODE when the 
request was queued, otherwise it is the preempt type of 
the request. 
- terminal in normal mode and non preemptive request 

2 - normal request, terminal was in console mode when 

the request was queued 

3 - soft preemptive, preempt reads with no data input 

1* - hard preemptive, preempt all non preemptive requests 



QLINK - SYSDB relative pointer to the next IOQ element, 
first word of the next element. 



Points to the 



QLDEV - Logical device number. 
QLDEVN Logical device number 



QMISC - Request state and flags 

FLUSH (FL) This flag is set when a control Y is detected and 

accepted while this request was waiting or being pro- 
cessed. Causes reads and writes to be successfully 
completed, although no I/O takes place. 

READSTOP Stop read operation if not zero. 

- null or no stop 

1 - break has been detected and is allowed 

2 - subsystem break has been detected and is allowed 

3 - request has been prompted 

It - read operation has been timed out 

5 - request has been aborted 

6 - block mode read has timed out 

NOTE: BIT 10 is NO STOP bit; suppresses aborts and prompts 

RSTATE Request state. Any codes not described below are unused. 




1 



2 
*U3 



5 - 



%30 



Request not started or new. 

Request has been started. Reads or writes may be 

waiting for the current write to finish to be 

continued. 

A read operation is in progress. 

A read operation has been completed but the data 

has not been transferred to the callers buffer. 

A read operation has been stopped. The cause and 

corresponding action to be taken is identified 

by the STOPREAD field in QMISC. 

Read initiation conditions have been checked and 

the read can be started as soon as the current 

operation (usually a write) is completed. 

Waiting (because 270 bytes tanked or no TBUFs) 

to enter a CRLF because a post space write follows 

a previous prespace write. 



13-123 



WKMMAL IOQ (COMT.) 



%31 - Waiting (because 270 bytes tanked or no TBUFs) to 

enter prespace carriage control bytes. 
%32 - Waiting (because 270 bytes tanked or no TBUFs9 to 

enter callers data into terminal buffers. 
%33 - Waiting (because 270 bytes tanked or no TBUFs) to. 

enter post space carriage control bytes. 
%3*» - %37 Correspond to states %30 - %33 but waiting to 
enter an ENQ for the 26k0/Uk. When the ENQ 
has been entered into the TBUF, the state 
reverts to the current state -U. 
STACKFLAG(SF) If the QADDR is the offset from DB to target 

address, otherwise QADDR is offset from DST base. 
QDSTN - Contains the data segment number of the target data area. 

QADDR - Offset to the target data area in the data segment or bank. 
For PTAPE reads, this word contains an SBUF index to the 
first of a pair of SBUFs used to read the data into. 

QFUHC - Function code. See ATTACHIO description for details. 

FUHC 

enable tapemode 

disable timer 

enable timer 

read timer 

disable parity 

enable parity 

logged on 

set parity 

set terminal type 

allocate terminal 

clear flush and write 

enable control X 111 echo 

disable control X i ) 1 ech 

not used 

PTAPE read 

set/reset break mode 

set/reset console mode 

QWBCT - Word or byte count and control returns. On initiation specifies 
a word count if positive or a byte count if negative. At 
completion of the request this location contains the actual 
transmission count in the same units as the call specified. 
Certain control requests return information through this 
location. 



QPAR1 - Parameter one. See first page of driver listing for details. 
QPAR2 - Parameter two. See first page of driver listing for details. 



Function code field. 




- 


read 


%17 


1 - 


write 


*20 


2 - 


file open 


%21 


3 - 


file close 


£22 


U - 


device close 


%23 


5 - 


set timeout 


*2U 


6 - 


set inspeed 


%25 


7 - 


set outspeed 


%26 


Jtto - 


echo on 


*27 


%ii - 


echo off 


*30 


%12 - 


disable break 


%31 


*13 - 


enable break 


%32 


JUU - 


disable escape 


%33 


%15 - 


enable escape 


%3U 


5H6 - 


disable tapemode 


%35 
%36 
%37 
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TERMINAL IOQ (CONT.) 



NOTE: During PTAPE reads, QPAR1 and QPAR2 contain a double 
word disc base address of the virtual memory area 
where the spooled data is saved temporarily. 



QSTAT - Request completion status and PCB number associated with this 
request. 



PCBN PCB number associated with request. If zero this IOQ 
element is returned by the system when the request is 
completed. 

QUALIFIER A code which further defines or qualifies the general 
status. See ATTACHIO description for details. 

STATUS General status. Indicates the current or resultant 

status of the request accorddng to the following codes. 

- not started or awaiting completion 

1 - successfully completed 

2 - end of file detected 

3 - unusual condition 

k - irrecoverable error 
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I/O QUEUE ELEMENT FOR 7976A HAG TAPE 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
+ — +--+--+ — + — +--+--+ — + — +--+--+ — + — + — +--+ — + 

Oj Request dependent flags (see below) | 



S7SDB relative pointer to next IOQ element. 
Points to first word of element. 



*10 



*11 



%12| 



| Logical device number 



R| B| F| G|BO| TOUTl FSCNTR | BSCNTR | RTCNTR 



S| If QFLAG.(3:1) is clear then this is the 
| DST number of the target data segment. If 
j S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



I Function code for 
| this request. (See 
| next section. ) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. Used only for reads. Contains 
the EOF specification in bits (13:3). 



Parameter 2. Used only for writes. If bit 
(13:1) is set, writing past EOT is allowed. 



PCBN 



| QUALIFIER | STATUS j 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 



- Abort this request and return an error indication 
to the caller. 

- Apply special handling to this request. (Not used) 

- This is a request from the diagnostic subsystem. 
(Not used) 

- Target is an index relative to the SBUF Table of 
the data buffer. 

- Wake caller on completion of request. 

- Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. 

Bit 6 COMPLETED - The request has been completed and the caller 

awakened if he had requested (with IOWAKE). 



Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit k IOWAKE 

Bit 5 BLOCKED 
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Bit 7 


DATAFRZN 


Bit 8 


MAMERRORD 


Bit 9 


PREQ 


Bit 10 


SFAIL 



Bit 11 PFAIL 



- Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 

- An error has occurred while MAM was trying to 
make the target data segment present and freeze 
it in memory. 

- (Not used) 

- Delayed failure of SIO instruction. If a call to 
START' HPIB resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

- The request was aborted because of a system power 
failure. 



QMISC - Driver request dependent flags and counters, 
error retries. 



Used mostly for 



Indicates an error retry is in progress. 
Backspace record processing for an error retry is in 
progress . 
FORWARD - Forward space record processing for an error retry is 
in progress. 

Gap processing for an error retry is in progress. 
Backspace record due to a data EOF processing is in 
progress. 

6IC timed-out counter. 
Forward space record counter. 
Backspace record counter. 
Error retry counter. 



RETRY 
BACK 



GAP 
BODEOF 

TOUTCKTR 
FSCNTR 
BSCKTR 
RTCKTR 



QSTAT - PCB number and request completion status. 

PCBN - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status . (See the section Driver Return Status Codes . ) 
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SERIES II/III LINE PRINTER I/O QUEUE ELEMENT (IOQ) 



1 2 3 U 5 6 7 8 9 10 11 12 13 1U 15 
0| Request dependent flags (see below) | 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



5H0 
%11 
5H2 



Physical unit number | Logical device number 



I WAITFLDl 



|RT|MC|PS|PP 



S| If QFLAG.(3:1) is clear then this is the 
I DST number of the target data segment. If 
I S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



Not used 



I Function code for 
| this request. See 
I next section. 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. The count is 
truncated to produce a max of 256 characters. 



Parameter 1 of QFUNC. 


See next section. 


Parameter 2 of QFUNC. 


See next section. 


PCBN | 


QUALIFIER | STATUS 



MNEMONIC 

QFLAG 

QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 

QSTAT 



QFLAG 

Bit 

Bit 1 
Bit 2 
Bit 3 

Bit k 
Bit 5 



Request dependent flags 



.ABORT 

.SPECIAL 

.DIAG 

.SYSBUFRS 

.IOW ARE 
.BLOCKED 



Bit 6 .COMPLETED 



- Request has been aborted externally, either by 
the operator or a system intrinsic. 

- Not used. 

- Not used. 

- Target is a system-buffer-relative index to the 
data buffer. * 

- Wake caller on completion of request. * 

- Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. * 

- Request has been completed, and the caller 
awakened if s/he had requested (with IOWAKE). * 
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Bit 7 .DATAFRZN - If set, then the data segment has been made 

present and frozen in memory. Set by the memory 
management routines (MAM) when a MAKEPRESENT 
request is successfully completed. * 

Bit 8 .HAMERRORD - An error has occurred while HAH was trying to 

make the target data segment present and freeze 
it in memory. * 

Bit 9 .PREQ - Not used. 

Bit 10 .SFAIL - Delayed failure of SIO instruction. If a call to 

STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the 
SIO instruction failed when the request was 
selected for execution. 

Bit 11 .PFAIL - The request was aborted because of a system power 

failure. 

Bitsl2-13 .PREHPT - Not used. 

Bit Ik . - Not used. 

Bit 15 .HSGDONE - Not used. 

QMISC.WAITFLD - This field contains a code describing the current 
idle state of the driver. The driver orients itself 
at each entry, based on the state of this field. 

- The current entry is the start of a new request. 

1 - The normal state while waiting for a completion 

interrupt of a print, fill or control operation. 

2 - An SIO channel program was in progress when 

an asynchronous interrupt (usually an exter- 
nal abort) occurred, or a 2607 printer was 
placed on-line after going off-line while 
printing. The driver enters this state and 
waits for three seconds for the channel pro- 
gram or 2607 printer to complete, so as not 
to pose control conflicts to the U.I. card 
between the driver and the program. 

3 - A Not Ready, Off Line or Paper Out (or Jammed) 

condition has been detected. The request will be 
continued or retried when the operator has 
corrected the condition and placed the printer on 
line. 
U - A 2607 (Tally) printer has come on-line af- 
ter going off-line while printing. One line 
of data is buffered in the printer. This 
state causes the driver to shift to state 2 
to allow the 2607 to print and space the 
buffered line before sending it the next 
line. 
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QMISC.(12:1) 

QMISC.(13:1) 
QMISC.(lU:l) 

QMISC. (15:1) 
QSTAT. PCBN 



QSTAT. STATUS 



QSTAT. QUALIFIER - A 



RETRY (RT). Kludge to catch an LDEV configured as a 

2608 when the physical device is a different subtype. 

Prevents Master Clear ' ing and retrying a request more 

than once when the Power Fail/Reset device status bit 

is "set" by a non-2608. 

MASTER' CLEAR (MC). Set when a 2608 Master Reset, 

required because of a printer Power Fail/Reset, is 

configured and executed. 

PRESPACE (PS). The current operation is a pre- 

space (space then print) request. This bit a- 

lerts the continuation section to fill the 

print buffer after spacing. 

PRE' TO' POST (PP). The previous request was a prespace 

operation while the current operation is a postspace. 

The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process, and the IOQ element is 
to be returned by the system when the request has 
completed. * 

General status. Indicates the final state of the 
request. The following codes are used: 

- Not started, or awaiting completion. 

1 - Successful completion. 

2 - Not used. 

3 - Unusual, but recoverable, condition (such as 

Request Aborted Externally) . 
l» - Irrecoverable error (such as SIO failure, 
memory parity error, etc.). 
code which further defines or qualifies the 



general status. 
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2608 LINE PRINTER I/O QUEUE ELEMENT (IOQ) -- HPIB SYSTEMS 



1 2 3 k 5 6 7 8 9 10 11 12 13 l*» 15 
0| Request dependent flags (see below) | 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



%10 



%11 



Logical device number 



PP | PE | MC j TOUTCNTR j 



WAITCODE 



S| If QFLAG. (3:1) is clear then this is the 
| DST number of the target data segment. If 
j S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



| Function code for 
j this request. (See 
j next section.) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. Vertical Format specification. 
(See next section for detail. ) 



Parameter 2. Space Mode Flags. (See next 
section for details.) 



%12| 
+- 



PCBN 



| QUALIFIER | STATUS | 
.+ + + 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 



- Abort this request and return an error indication 
to the caller. 

- Apply special handling to this request. (Not used) 

- This is a request from the diagnostic subsystem. 
(Not used) 

- Target is an index relative to the SBUF Table of 
the data buffer. 

- Wake caller on completion of request. 

- Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. 

Bit 6 COMPLETED - The request has been completed and the caller 

awakened if he had requested (with IOWAKE). 



Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit U IOWAKE 

Bit 5 BLOCKED 
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Bit 7 DATAFRZN 



Bit 8 MAMERRORD - 



Bit 9 PREQ 
Bit 10 SFAIL 



Bit 11 PFAIL 



Set by the memory management routines (MAM) when a 
MAKEPRESEMT request is successfully completed and 
indicates the data segment is frozen in memory. 
An error has occurred while MAM was trying to 
make the target data segment present and freeze 
it in memory. 

- (Hot used) 

- Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

- The request was aborted because of a system power 
failure . 



QMISC - Driver request dependent flags and counters. 



PRE'TO'POST 

PEJECT 

MASTERCLR 

TOUTCHTR 
WAITCODE 



Pre to post spacing change flag. 

Last operation was a page eject. 

Master clear done to clear powerfail bit in status. 

Master clear needs to be done from not ready conditon. 

Channel time-out retry counter. 

Indicates type of wait: 

- new request 

1 - completion wait 

2 - not ready wait 



QSTAT - PCB number and request completion status. 

PCBH - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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2608 Line Printer Request Codes 



Operation Function 
WRITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE U 

READ STATUS %17 



Parameters 

PI - Vertical Format Specification 

1 - use 1st data char as format spec 

%53 - "+", print and suppress spacing 
%55 _ "-"» print and triple space 
%60 - "0", print and double space 
%6l - "1", print and top of form 

%200-%277, print and space N-%200 lines 
%300-%377, print with channel N-%277 

All others, print and single space. 

P2 - Space Mode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(lU:l) - Ho page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
with stepover (60 lines/page) 

Page eject if not at top of form 

Page eject if not at top of form 

Page eject if not at top of form 

Read I/O status 

Count - buffer must be at least 2 bytes 



VFC SET %100 Load VFC RAM 

Count - form length in words 

(0 loads RAM form internal ROM) 
PI - 6 for 6 LPI or 8 for 8 LPI 

any other value defaults to 6 LPI 

TAB SET %101 Sets logical column definition 

PI - to 15, any other value defaults to 15 
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2619A AND 2631 LINE PRINTER I/O QUEUE ELEMENT (IOQ) -- HPIB SYSTEMS 



1 2 3 fc 5 6 7 8 9 10 11 12 13 Ik 15 
+ — +--+ — +--+ — +--+ — +--+ — +--+ — +--+ — + — + — +--+ 

0| Request dependent flags (see below) | 



SYSDB relative pointer to next IOQ element. 
Points to first word of element. 



*10 



5H1 



Logical device number 



PP|PE|PF|TOUTCNTR| 



WAITCODE 



S| If QFLAG.(3:1) is clear then this is the 
I DST number of the target data segment. If 
i S is set, QADDR is DB relative. 



Offset in the data segment or system buffer 
table to the target data buffer. 



I Function code for 
I this request. (See 
i next section. ) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



Parameter 1. Vertical Format specification. 
(See next section for detail. ) 



Parameter 2. Space Mode Flags. (See next 
section for details.) 



%12| 
+- 



PCBN 



I QUALIFIER I STATUS | 
.+ + + 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 
QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 



- Abort this request and return an error indication 
to the caller. 

- Apply special handling to this request. (Not used) 

- This is a request from the diagnostic subsystem. 
(Not used) 

- Target is an index relative to the SBUF Table of 
the data buffer. 

- Wake caller on completion of request. 

- Blocked I/O. The caller is waited in ATTACHIO 
""til the request is completed. Implies IOWAKE. 

Bit 6 COMPLETED - The request has been completed and the caller 

awakened if he had requested (with IOWAKE). 



Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit U IOWAKE 

Bit 5 BLOCKED 
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Bit 7 


DATAFRZN 


Bit 8 


MAMERRORD 


Bit 9 


PREQ 


Bit 10 


SFAIL 



Bit 11 PFAIL 



Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 
An error has occurred while MAM was trying to 
make the target data segment present and freeze 
it in memory. 
(Not used) 

Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

The request was aborted because of a system power 
failure . 



QMISC - Driver request dependent flags and counters for 2631. 

PRE" TO' POST - Pre to post spacing change flag. 

PEJECT - Last operation was a page eject. 

TOUTCNTR - Channel time-out retry counter. 

POWERFAIL - Power fail flag indicates power fail occurred. 

WAITCODE - Indicates type of wait: 

- new request 

1 - completion wait 

2 - not ready wait 



Format for 2619A 

1 2 3 h 
|PP|PE|PF|TO|BF| 



12 15 
I WAITCODE I 



TOUT - Channel timed out flag 

BUF'FILL - Buffer fill operation in progress 

QSTAT - PCB number and request completion status. 

PCBH - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
h - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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2619 Line Printer Request Codes 



Operation Function 
WRITE 1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE U 

READ STATUS %17 



•IDENTIFY 



STATUS 



%110 



•SELF TEST: 

INITIATE %111 



%112 



•LOOPBACK TEST: 
WRT DATA %113 
READ DATA %llU 



Parameters 

PI - Vertical Format Specification 
1 - Use 1st data char as format 
specification. 

#53 - "+", print and suppress spacing 

%55 ~ """> print and triple space 

%60 - "0" , print and double space 

%6l - "1", print and top of form 

%200-%277, print and space N-%200 lines 
%300-%312, print with channel N-%277 

%320 - Fill Line Printer Buffer Only 

All others, print and single space. 

P2 - Space Mode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(lU:l) - No page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
with stepover (60 lines /page) 

Page eject if not at top of form 

Page eject if not at top of form 

Page eject if not at top of form 

Read I/O status 

Count - buffer size 

Return ID value in Bank & Buf faddr 



Subtest number to execute in Bank and Buffaddr 

(subtest number ranges from to 7) 
Subtest result returned in Bank 4 Buffaddr 



Data to LP in Bank & Buffaddr [PING] 

Data from LP read into Bank & Buffaddr [PONG] 

Count - Buffer Size (256 bytes max) 



1 -J_1 o< 

J.J ijO 



Operation Function 
WRITE 1 



2631 Line Printer Request Codes - HPIB 



Parameters 

PI - Vertical Format Specification 
1 - Use 1st data char as format 
specification. 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE U 

READ STATUS %17 



%53 
%55 
%60 

*6l 



- + , print and suppress spacing 

- "-", print and triple space 

- "0", print and double space 

- "1", print and top of form 



%200-%277, print and space N-%200 lines 
%300-%307, print with channel N-%277 

%320 - Fill Line Printer Buffer Only 

All others, print and single space. 

P2 - Space Mode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(lU:l) - Ho page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
with stepover (60 lines/page) 

Page eject if not at top of form 

Page eject if not at top of form 

Page eject if not at top of form 

Read I/O status 

Count - 1 byte minumum required 



VFC SET JfcLOO LOADS VFC RAM 

PI - 1-1 LPI (lines per inch) 

2 - 2 LPI 

3 - 3 LPI 
h - U LPI 

5 " 5 LPI 

6 - 6 LPI 
8 - 8 LPI 

12 - 12 LPI 

Any other value defaults to 6 LPI. 
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CARD READER IOQ 



1 2 3 U 5 6 7 8 9 10 11 12 13 ll» 15 
0| (SEE BELOW) 



II 
I 

21 
I- 

31 
I- 

I- 
51 

I- 

61 
I- 

71 
I- 
»0| 

I- 
%lll 



»2| 



I 



IOQP POINTER TO NEXT REQUEST 



UNIT # 



LOGICAL DEVICE # 



AUXILIARY BUFFER FLAG 



DST NUMBER OR 
OFFSET IN DST OR BANK 



I FUNCTION CODE 
WORD(+) OR BTTE(-) COUNT 



PCB NUMBER 



BITO ABORT 
BIT1 SPECIAL 
BIT2 DIAGNOSTIC 
BIT3 SYS BUFFER 
BITl* 10 WAKE 
BIT5 BLOCKED 
BIT6 COMPLETED 
BIT7 DATA FREEZE 
BIT8 MAM ERROR 
BIT9 
BIT10 SFAIL 
BIT11 PFAIL 



I EOF 



BINARY 



I QUALIFIER | STATUS 



QFLAGS 

QLINK 

QLDEV 

QMISC 

QDSTN 

QADDR 

QFUNC 

QWBCT 

QPAR1 

QPAR2 

QSTAT 
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CARD READER IOQ (CONT. ) 



QFLAG - Flags and request state. 



ABORT Abort this request and return an error indication to the 
caller. 

SPECIAL Special handling is to be applied to this request. Has 
no meaning for card reader requests. 

DIAGNOSTIC This is a request from a diagnostic subsystem. Not 
used by card reader driver. 

SYSBUFRS Target is an index relative to the SBUF table of the 
data buffer. 

IOWAKE Wake caller on completion of request. 

BLOCKED Blocked I/O. The caller is waited in ATTACHIO until 
the request is completed. Implies wake. 

COMPLETED Request has been completed and caller woken if requested. 

DATAFRZN If set then the data segment has been frozen in memory. 
Set by MAM when a MAKEPRESENT request is successfully 
completed . 

MAMERRD An error has occurred in trying to make the target data 
segment present and freeze it in core. 

SFAIL SIO program failed to start because a) device didn't 
respond, or b) request has queued because device was 
busy. 

PFAIL This request has been aborted because of a power failure. 

QLINK - S7SDB relative pointer to the next IOQ element. Points to the 
first word of the next element. 

QLDEV - Logical device number. 

QLDEVN Logical device number. 

QMISC - Auxiliary buffer flag. When odd. Data is being read into an 
auxiliary buffer because the requested count is less than UO 
words . 

QDSTN - Contains the data segment number of the target data area. 
QADDR - Offset to the target data area in the data segment or bank. 



13-139 



CARD READER IOQ (CONT. ) 



QFUNC - Function code. See ATTACHIO description for details. 
FUNC Function code field. 
- read 

2 - file open (no operation) 

3 - file close (no operation) 

k - device close (clear EOF field in LPDT) 



QWBCT - Word or byte count and control returns. On initiation 
specifies a word count if positive or a byte count if 
negative. At completion of the request this location contains 
the actual transmission count in the same units as the call 
specified. Odd counts are rounded up to produce reads of an 
even number of bytes. All counts are truncated to produce 
maximum reads of Uo words for ASCII or 80 words for column 
binary. 



QPAR1 - End of file specification. See EOFCHECK write up for details. 
QPAR2 - Binary /ASCII specification. 



BINARY If then ASCII code conversion; Uo words maximum read. 
If not then column binary read; 80 words maximum read. 



QSTAT - Request completion status and PCB number associated with this 
request . 



PCBH PCB number associated with request. If zero this IOQ 
element is returned by the system when the request is 
completed. 

STATUS General Status. See general IOQ entry for specifications. 

QUALIFIER Driver specific status. See general IOQ entry. 
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I/O QUEUE ELEMENT FOR HPIB CARD READER 



1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 
+ — + — + — + — + — +--♦ — + — + — +--+ — + — + — +--+ — + — + 

0| Request dependent flags (see below) | 

lj SYSDB relative pointer to next IOQ element, 
j Points to first word of element. 



Logical device number 



21 
+._+._+--+ — +_-+ + — + + + 

3| Auxiliary buffer flag. 
+ — + — + — + — + — + +_-_._ — + + 

H| S| If QTLAG.(3:1) is clear then this is the 
j | DST number of the target data segment 
| | S is set, QADDR is DB relative. 



If 



51 Offset in the data segment or system buffer 
| table to the target data buffer. 



61 

I 
I 
+■ 

71 
I 



| Function code for 
j this request. (See 
I next section.) 



On initiation, specifies the word count (>0) 
or byte count (<0). At completion of the 
request this location contains the actual 
transmission count in the same units (bytes 
or words) as in the request. 



*10| 

%11| 

I 
I 

%12| 

+ 



Parameter 1. Contains the EOF specification 



Parameter 2. Contains the data mode 
specification in bits (11:2). (See below card 
reader request codes for detail information) 



PCBH 



| QUALIFIER 



| STATUS 
-♦ 



MNEMONIC 
QFLAG 
QLINK 

QLDEV 
QMISC 
QDSTN 

QADDR 
QFUNC 

QWBCT 



QPAR1 
QPAR2 

QSTAT 



QFLAG - Request dependent flags 



Bit ABORT 

Bit 1 SPECIAL 

Bit 2 DIAG 

Bit 3 SYSBUFF 

Bit U IOWAKE 

Bit 5 BLOCKED 

Bit 6 COMPLETED 

Bit 7 DATAFRZN 



Abort this request and return an error indication 
to the caller. 

Apply special handling to this request. (Not used) 
This is a request from the diagnostic subsystem. 
Target is an index relative to the SBUF Table of 
the data buffer. 

Wake caller on completion of request. 
Blocked I/O. The caller is waited in ATTACHIO 
until the request is completed. Implies IOWAKE. 
The request has been completed and the caller 
awakened if he had requested (with IOWAKE). 
• Set by the memory management routines (MAM) when a 
MAKEPRESENT request is successfully completed and 
indicates the data segment is frozen in memory. 
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Bit 8 MAMERRORD - An error has occurred while MAM was trying to 

make the target data segment present and freeze 
it in memory. 

Bit 9 PREQ - (Not used) 

Bit 10 SFAIL - Delayed failure of SIO instruction. If a call to 

STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed when the request was selected 
for execution. 

Bit 11 PFAIL - The request was aborted because of a system power 

failure . 



QMISC - Auxiliary buffer flag used to indicated a read into the 
driver's buffer and not the user's buffer. 



QSTAT - PCB number and request completion status. 

PCBH - The Process Control Block (PCB) number of the process 
which made this request. If zero, the request is not 
associated with any process and the IOQ element is to 
be returned by the system when the request has completed. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting completion. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
U - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 
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DATA COMMUNICATIONS IOQ ENTRY 

1 2 3 fc 5 6 7 8 9 10 11 12 13 l 1 * 15 

OJ (SEE BELOW) 

I " 

lj NEXT IOQP 

I 

2| UNIT I | QLDEVN 

I 

3| IOQ STATN/LAST STATN REF 

I " i 

U|S | BUFFER DST 

i - 

51 BUFFERl ADDR 

I- " 

6| I FUNCTION 

I 

71 COUNT/TLOG 

I 

8 1 BUFFER2 ADDR/CONTROL CODE 

! 

9| TCOUNT2/PARAHETER 

I 

10| USER PCBN | I/O QS I I/O GS 

I 



S=STACKFLAG 



QS=QUALIFIED STATUS 
GSsGENERAL STATUS 



BITO ABORT 


BIT3 SYS BUFFER 


BITU 10 WAKE 


BIT5 BLOCKED 


BIT6 COMPLETED 


BIT7 DATA FROZEN 


BIT8 MAM ERROR 


BIT 10 SFAIL 


BIT11 PFAIL 


BITlU TIMER 


BIT15 MS6 ERROR 


Word .ABORT 


.SYSBUF 


.IOWAKE 


.BLOCKED 


.COMPLETE 


.DATAFRZN 


•MAMERRORD 


.SFAIL 


.PFAIL 


.TIMED 


.MSGDONE 



CSS OFFENDING 

GS 1=SUCCESSFUL 

GS 2=END OF TRANSMISSION 

RECEIVED 
GS 3*UNUSUAL CONDITION 



Abort this I/O request 

Data is in system buffers 

Wake caller upon completion 

Blocked I/O, do blocked AWAKE 

when I/O is complete 

Request has been completed 

The DST has been frozen 

MAM failed to freeze the DST 

The I/O program failed to start 

due to no SIO OK 

The Abort bit was set because 

of a power failure 

An I/O timeout request has completed 

A message reply has been completed 
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SBUF AND TBUF TABLE LAYOUT 



SECONDARY # | PRIMARY # 
IMPEDED PROCESS PCB | ENTRY SIZE 
HEAD INDEX 



TAIL INDEX 
MAXIMUM OF IN USE I CURRENT IN USE 



3-I-5-U-2 



OVERFLOWS 



TOTAL 
REQUESTS 



INDEX OF 5 



ENTRY 1 



ENTRY 2 



INDEX OF 1 



ENTRY 3 



INDEX OF 2 



ENTRY U 
(IN USE ) 



INDEX OF U 



ENTRY 5 



TSIZE 

TREAD 

TTAIL 

TUSE 

TOVRFL 

TRQSTS 
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TABLE ELEMENT ALLOCATION (TBUF AND SBUF) 



The allocation of the elements in the IOQ terminal buffer (TBUF) and 
system buffer (SBUF) tables is of concern to the I/O system. 



FREE LIST OF TABLE ELEMENTS 

These tables are in the form of a free-linked list of the free elements. 
For the SBUF's the -1 word of entry is the link to the next element. 
For the TBUF's, word zero is the link and word 1 is the link for the 
IOQ elements. 

Each word has an 8-word header beginning at the base of the table. The 
first four words of the header are for managing the table and the second 
four are for monitoring table activity. 

The entries follow the header at word eight. 



ELEMENT ALLOCATION 

Elements are obtained from the beginning of the free list, pointed to 
by the head and returned to the end of the free list pointed by the tail. 

When the free list is empty, the head index is zero and the tail index 
is set to point at the head index. 

The tables are divided into two areas: a primary and a secondary area. 
Most requests are obtained from the primary area. The secondary area is 
used only for critical requirements when the primary area is exhausted. 
These areas are logical areas determined by parameters in the header. 

The utility of the core resident tables is seriously reduced if their 
use is not restricted to dynamic situations. 

One of three responses must be specified to the routines which allocate 
elements from the I/O system tables. 

1. Impede caller if primary is empty. 

2. Get from primary area only. 

3. Get from secondary area if primary area is empty. 
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TABLE ELEMENT ALLOCATION (CONT. ) 



Request types 2 and 3 return an indication to the caller if the request 
could not be satisfied. The following table specifies the types of calls 
for element allocation and the action if an element is not activated. 



BUFFER USER 
SBUF's 



CALL TYPE 



FINAL ACTION 



File system 
Ptape 
Bad track 

TBUF's 

Terminal write (impedable) 
Terminal write (not impedable) 
Terminal read on ICS 
Log error 

IOQ's 

ATTACHIO (not impedable) 
ATTACHIO (impedable) 
SIODH (memory management) 
IOMESSAGE 



Impede 
Impede 
Primary 


Forget request 


Impede 
Primary 
Secondary 
Primary 


I/O error 
I/O error 
Forget request 


Primary 
Impede 
Secondary 
Secondary 


Return IOQX-0 

Sudden death 
I/O error 



HEADER DEFINITION 



Primary # 
Total # 
Size 
Impeded PCB 

Head index 
Tail index 
In use 
Overflows 
Total requests 



Number of elements in the primary area. 

Total number of elements in the table. 

Size in words of each element. 

If not zero then contains the PCB number of the 

first process waiting for an element in this table. 

Index of first free element. 

Index of last free element. 

Current number not in free list. 

Number of requests made for an element. 

Total number of elements requested. 
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QI - 







ICS GLOBAL 






63 
50. 




RESERVED 




k9 


CANDPIN 




1*8 


LAST WEIGHT 




U7 
1*6 


PAUSETIHE 




*5 


LISTSTATE 




1*1* 


CUREFILTER 




U3 


CURDFILTER 




1*2 


CWTNUM 




1*1 


CWTDENON 




1*0 


CURCFILTER 




39 


MAXCFILTER 




38 


MINCFILTER 




37 


ESCHEDBASE 




36 


DSCHEDBASE 




35 


CSCHEDBASE 




3U 


WORSTEPRI 




33 


WORSTDPRI 




32 


WORSTCPRI 




31 


MISC. BOUNDS FLAGS 






SYSTEM MEM BOUND 




29 


XDS UPPER BOUND 




28 


DL INITIAL 
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iii 



271 



RESERVED 



22 



01 



21 1 
20 1 


PAUSETIME 


191 


PAUSECODE 


18! 


DISAP 


17! 


Reserved 


16 1 


SDST 


15 


PSTA 


1U 


PADDR 


13 


TRACE FLAG 


12 


PFAIL 


11 


JCUT 


10 


XP 


9 


PCBX 


8 


Z 


7 


DL 


6 


: S 


5 


I SBANK 


h 


I STDB 


3 


i o 


2 


1 P 


1 


I STATUS 





IP 1 o 


+1 


I DB BANK RETURN 




I DB RETURN 




|D | PARM 



MPE III ONLY! 
MPE III ONLY! 

MPE III ONLY! 

PSEN, PSDB counter 

process' stack DST# 

pseudo- interrupt status 

pseudo- interrupt address 

flag set non-zero on IXIT away from ICS 

PTR to powerfail PCB 

absolute JCUT address 

pointer to executing process PCB 

absolute stack address 

stack DB relative Z 

stack DB relative DL 

stack DB relative S 

stack bank 

absolute stack DB 



> DISPATCH stack marker 



I 



> FOR DISPATCH 
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P=PSEUDO-DISABLED AMD DISP INSTRUCTION EXECUTED. 
D=DISPATCHER INTERRUPTED. 

-19 PAUSECODE(MPE III ONLY) : = system not paused 1 = paused for disc 

2 = paused for swap 3 = system idle 



n-1 Uo 



ICS GLOBAL CELLS, with initial values 



STDB - absolute address of the currently running process's stack. 
SBANK - bank address for process' stack. 
S - stack DB relatives 
DL - stack DB relative DL 
Z - stack DB relative Z 
PCBX - absolute stack address 

XP - PCB table relative pointer to word of the running process 
PCB. 

The above cells are to be initialized for the PROGENITOR. 

CPCB - absolute U, is an absolute version of XP. If CPCB is zero, 
then the above cells are invalid. This will never be the 
case in a process. CPCB should also be set by INITIAL. 

SDST - DST# for running process' stack. 

JCUT - the bank zero absolute address of the JCUT table. 

PADDR - PB relative address for the procedure PSEUDOINT. 

PSTA - status value for PSEUDOINT, JilUOOO0+CST# . 

DISAP - PSDB counter, initially 0. 

INITIAL sets the above as described. 
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CHAPTER lU SPOOLING 



INPUT DEVICE DIRECTORY/OUTPUT DEVICE DIRECTORY 



7 8 



15 



2 



DD| NEXT DEVICE FILE ID 



/////////////////////I ^CE 



10 



11 



12 



13 



MAXSIZE 



HEADSIZE 



CURSIZE 



ENTRYSIZE 



SUBENTRY AREA POINTER 



/////////////////////////////// 



/////////////////////////////// 



/////////////////////////////// 



DEVICE OOTFENCEl 



LDEVf 



HEADP 



TAILP 



/////////////////////////////// 



HEAD ENTRY 



HEAD ENTRY 



ETC 



1st SUBENTRY AREA 



SUBENTRY AREA 



ETC 



MAXSIZE-SIZE (WORDS/128) 
CURSIZE -SIZE (WORDS /128) 
HEADSIZE-SIZE m(U) 
ENTRYSIZE-SIZE (36(8)=30(10) ) 

DD-0=INPUT DEVICE DIRECTORY 

l=OUTPUT DEVICE DIRECTORY 
FENCE -SEE JMAT DEFINITION 



7 DEVICE OUTFENCE IS 
|— > ZERO IF FENCE (WD U) 

8 \ — | IS TO BE USED 

I 

9 >lst HEAD ENTRY 

I 
10/ 



11 



HEADP/TAILP-HEAD POINTER 
IMMEDIATELY FOLLOWED BY 
TAILPOINTER. EACH POINTS TO 
WORD OF SUBENTRY. NULL CHAIN: 
HEAD=0 TAIL=ADDRESS OF HEAD. 
CHAIN TERMINATED BY A LINK 
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XDD (IDD/ODD) SUBENTRY FORMAT 



•>BIT RESERVED FOR TAPE LABELS 





1 
2 

3 
k 

5 
6 
7 
10 
11 
12 
13 

Ik 

15 
16 

17 
20 
21 
22 
23 
2U 

25 



1 2 3 *» 5 6 7 8 9 10 11 12 13 H is 



ST 



OUTPRI 



TY 



C| 
I--I 



DEVICE 



JNUMBER 



USER NAME 



ACCOUNT NAME 



JOB NAME 



FILE NAME 



DEVICE FILE ID 
TF|DA|/////////////| HEADX 



LOGICAL DEVICE | LABEL 

SECTOR ADDRESS 



2 

3 
l* 

5 
6 
7 
8 

9 

10 

11 

12 

13 

ll* 

15 
16 

17 
18 

19 
20 
21 



NOTE 1 
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XDD SUBENTRY FORMAT (CONT.) 



26 | NUMBER OF EXTENTS | LDEV 

| 

27| LAST EXTENT SIZE 

I - 

30|SQZ|/|RS| F| S|AB|//| NUMCOPIES 

I — 

31 1 LINK POINTER 

I 

32 1 

I NUMBER OF IMAGES 

331 

| 

3>»l 

I TIME MADE READY 

351 

| „ 

SQZ- EXTENT PURGING AFTER EXTENT PRINTED 
ST -STATE OF ENTRY 

0=ACTIVE 

1=READY 

2=OPENED 

3=IGNORE (LOCKED) 

C -DEVICE IS A CLASS INDEX TO DEVICE 
CLASS TABLE 

TY-JOB TYPE 

0=SESSION' (SPOOK) 

l=SESSION 

2=JOB 

3= JOB' (SPOOK) 
TF-1=THERE EXISTS FORMS 
DA-1=:DATA CREATED INPUT FILE 

HEADX-INDEX OF HEAD ENTRY FOR 

THIS CHAIN OF SUBENTRIES 
RS-1=RESTART IS REQUESTED IF WARM- 
START WAS NECESSARY 

F - 1=N0N-STANDARD FORM CONTROL 
ON DEVICE 

S - 1=FAILURE DURING ALLOCATION OF 

NEW EXTENT 
AB - ABORTED JOB $STDLIST ENTRY 

NOTE 1 - SPOOLFILE EXTENSION 
OR LABEL EXTENSION 



22 

23 
2U 

25 
26 

27 
28 
29 
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SPOOK Tape Format 



The overall format of output tapes produced by the SPOOK "OUTPUT" 
command is shown below. The various components of the tape are 
then described in detail. The format described here is subject 
to change as MPE evolves. Also, there may be errors in SPOOK 
which would cause the actual tape format to differ from the one 
described here in some cases. All numeric information is in 
integer format unless otherwise specified. 



EOF 

EOF 

Label Record 

EOF 

File Directory Records 

Device and Class Directory Record 

EOF 

Spoolfile 

EOF 

Spoolfile 

EOF 



Mechanisms for End-of-tape and tape switching are the same as for 
STORE/RESTORE tapes. 



Label Record 



Words 0-13: SPOOLFILETAPE LABEL-HP3000 . ! 

i 
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Word 23 
Word 24 
Words 25&26 



reel number (first reel is number 1) 
date (from CALENDAR intrinsic) 
time (from CLOCK intrinsic) 



All other words are zero. 



File Directory 

The File Directory has one entry for each spoolfile on the tape. 
Each entry is 12 words, and entries are packed into as many 1020- 
word records as needed. The last record will be padded with 
zeros if necessary. The entry format is: 



Word 

Words 1-3 

Words 4-7 

Words 8-11 



Device file id number (bit is on to indicate 
that the file is an output spoolfile) 

zero 

User name 

Account Name 



Device and Class Directory 

The Device and Class Directory is contained in one 1024-word 
record. There is no EOF separating this record from the File 
Directory. This directory contains one entry for each logical 
device or device class linked to the spoolfiles on the tape. 
Also, there is an entry for each logical deviee in each class in 
the directory, whether or not that logical device was directly 
referenced by a spoolfile. The entries are packed into the tape 
record one after another in no particular order. The entry 
formats are shown below. 



Logical Device Entry 
Word 0: logical device number 
Word 1: 



Bits 0:8 
Bits 8:8 



device subtype 

3 (=length of this entry in words) 
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Word 2: device type 
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Device Class Entry 

Word 0: Device class number (negated). This is the number 
of the entry of this device class in the system's 
Device Class Table. 

Word 1: Total number of words in this entry. 

Words 2 on: The entire contents of the Device Class Table entry 
for this device class. 



There is one known bug in the Device and Class Directory. The 
last logical device in each class will be skipped when generating 
device entries for the members of the class. Unless that logical 
device is entered into the directory for some other reason, it 
will not be present. 



Spoolfile Format 

ODD entry (30-word tape record) 

Spoolfile block — > Two spoolfile blocks packed into one 
Spoolfile block 1024- word tape record. 

Two spoolfile blocks 

Two spoolfile blocks 



The first few spoolfile blocks have been modified to contain ! 

user label information from the spoolfile. This is explained ! 

later . ! 



Spoolfile Block Format 



A spoolfile block is a 512-word block that contains variable 
length records in spooler format. The 2680 is intimately famil- 
iar with this structure. Any effort to change this format should 
be cleared with the 2680 project in Boise first! Spoolfile rec- 
ords start at the first word of the block. The last record is 
followed by a -1 to indicate that no more records follow. The 
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last two words of the block contain a doubleword which is the ! 

record number of the first record in the block. ! 



Spoolfile Record Format 

Word 0: Byte count of record - 2 

Word 1: Byte count of data portion of record. Note 
that this count includes trailing blanks. 
However, trailing blanks are truncated in 
the actual record, so this count may be 
more than the number of bytes actually 
present in the data portion. 

Word 2: Function Code: l=Fwrite 

2=Fcontrol 
3=Fopen 
4=Fclose 
JS200 and beyond=Fdevicecontrol 

Word 3: PI — ATTACHIO parameter 

Word 4: P2 — ATTACHIO parameter 

Words 5 on: Data Portion of Record 



User Labels Information 

In the C-Mit and newer MPE versions, spoolfiles have a number of 

user labels with several kinds of information. These are: ! 



i 



1. Master: user label 0. 

2. FOPEN entry catalog: user labels 1-10. 

3. Circular queue for restart checkpointing: user labels 



i 

j 

i 
11-27. " I 

Since older versions of MPE did not use user labels, a way was 
needed to incorporate them into the SPOOK tape format without 
losing forward and backward compatibility. The method used is to 
add several special spoolfile blocks to the beginning of the 
spoolfile on tape. Each of these blocks has exactly one FOPEN 
record at its beginning. This record is followed by a -1. Thus 
old versions of MPE will assume that the rest of the block is 



garbage. However, the rest of the block is actually used to con- 
tain user label information. The first two spoolfile blocks 
(i.e. the first tape record of the spoolfile proper) contain only 
the FOPEN records. The next 5 tape records actually contain user 
labels in addition to the FOPEN records. The user labels are 
packed 3 to a spoolfile block, 6 to a tape record. Each spool- 
file block of 512 words has the following format: 

Words 0-4: FOPEN record 

Word 5: -1 (to "terminate" the block) 

Words J6200-JS377: user label 

Words %400-%577: user label 

Words J&600-5S777: user label 

Following this special group of blocks, the spoolfile resumes a 
normal format. The special FOPEN records all have the number of 
user labels in P2. 

It is often the case that some of the 27 user labels have not 
been initialized before the tape is written. In that case, their 
places will be filled with garbage. There is no easy way of de- 
tecting this except by careful inspection. 
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CHAPTER 15 UNIFIED COMMAND LANGUAGE (UNCL) 



REPLY INFORMATION TABLE (RIT) 

DST %3U; SIR %25 



NUMBER OF ENTRIES 



MAX NUMBER OF ENTRIES 



PROCESS NUMBER (PIN) 



DST# (FOR REPLY) 



BUFFER ADDRESS (DST RELATIVE) 



MAX LENGTH OF STRING | REPLY TYPE EXPECTED 



# BYTES IN MESSAGE 



MESSAGE IN ASCII 
(UP TO Jh CHARS.) 



\ 

I TABLE 

| HEADER (2 WDS.) 

/ 

\ 



NOTE: Process Number = means entry is empty 

Reply Type = for number (mini) 

= 1 for yes or no (y/n) 

= 2 for string (sxx) 

= 3 for yes, no, or STRING 

TABLE SIZE = 102U words 

MAX # OF ENTRIES = 22 

= k for string 



ENTRY 
(U5 WDS.) 
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MESSAGE SYSTEM GENERAL DESCRIPTION 



The message system consists of the following parts: 

- Callable intrinsic GENMESSAGE. 

- Uncallable procedure GENMSG which is used by MPE. 

- System message catalog (CATALOG. PUB. SYS) and any number of 
user catalogs. 

- Program MAKECAT which builds message catalogs. 

- MESSAGE SIR %2k 

- MESSAGE SYSGLOB CELLS %371"373 

- MESSAGE DATA SEGMENT 

The message system is used by calling GENMESSAGE (or GENMSG) with a 
message number. The message system fetches the message from a message 
catalog, inserts parameters, then routes the message to a file or 
returns the message in a buffer to the caller. 

A message catalog is a numbered editor-type file containing sets of 
messages. The sets serve to break a catalog into managable portions. 
A message system user may call GENMESSAGE using either his own message 
catalog or using MPE's catalog (CATALOG. PUB. SYS). 

After creating a message file, run the program MAKECAT in order to 
build a catalog that is readable by the message system. This file is 
still readable by the editor (it can be "texted") but it contains a 
directory (written as a user label) . 

In order to use the message catalog, the program must first open the 
message catalog, then call GENMESSAGE with the file number, set number 
and message number. (MPE users don't need to open the catalog, GENMSG 
automatically uses CATALOG . PUB . SYS . ) The file must be opened with the 
aoptions "NOBUF" and "MULTI" -record access. 

MESSAGE CATALOG 



Messages in the catalog can be of any length and can contain up to 
five parameters. Continuation of a message is indicated by "%" or "&" 
at the end of a line. The "%" symbol indicates that the message is 
continued and that a carriage return, line feed be issued the 
terminal. The "&" symbol indicates that the message is continued on 
the same line with no carriage return, line feed. 

Parameters may be inserted into the message fetched from the catalog. 
The parameters are passed in the GENMESSAGE (or GENMSG) call and 
inserted wherever a "!" is found. Message sets are indicated by "$SET 
n" starting in column 1 (the rest of the line is treated as a 
comment). Maximum value for n is 63. Comments can be inserted in the 
catalog by placing "$" in column 1. Message numbers are positive 
integers, need not be contiguous, but must be in ascending order. 
After processing by the program MAKECAT, the catalog file" contains 
records of 80 bytes, blocked 16, in 32 extents. (The system message 
catalog is only one extent, however). The format of the message 
catalog is as follows: 
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MESSAGE SYSTEM (CONT.) 



$SET 1 SYSTEM MESSAGES 

1 LDEV #! IN USE BY FILE SYSTEM 

2 LDEV #! IN USE BY DIAGNOSTICS 

3 LDEV IN USE, DOWN PENDING 



5 IS 



ON LDEV#! (Y/N)? 



$ MESSAGE 35 IS TWO LINES LONG, A PARAMETER STARTS THE 
$ FIRST LINE AND THE SECOND LINE IS "HP32002" 

35 •% 
HP32002B.00.! 



276 LDEV # FOR "!" ON ! (NUM)! 

$ 

$SET 2 CIERROR MESSAGES 

82 STREAM FACILITY NOT ENABLED: SEE OPERATOR. (CIERR 82) 

200 MORE THAN 30 PARAMETERS TO BUILD COMMAND. (CIERR 200) 



20U FILE COMMAND REQUIRES AT LEAST TWO PARAMETERS, INCLUDING THE 
FORMAL NAME OF THE FILE (CIERR 20U) 



MAKECAT PROGRAM 



The program MAKECAT. PUB. SYS is used to build message catalogs (and 
also HELP catalogs). The program's input file has the 
formaldesignator INPUT, which must be used for all entry points. 
The program has the following entry points: 



(no entry 
point) 



BUILD 



- Reads from input file and builds a temporary file 
(formaldesignator CATALOG). Also renames any old 
temporary CATALOG, CATnn, using an archival 
numbering scheme (i.e., CAT1, CAT2, etc.). 

- (Must log on under MANAGER. SYS. ) Reads from input 
file, build the system message catalog 
(formaldesignator CATALOG), and installs the message 
system. Existing catalog is renamed CATnnnn according 
to the same scheme as for no entry point (above). 
Installation of the message system means moving the 
directory contained in the userlabel of the catalog 
into a data segment. The DST number and the disc 
address of CATALOG are placed in system global area. 
The message system may be installed while the system 
is running. 
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MESSAGE SYSTEM (CONT.) 



DIR - (Must have PM or OP capability.) Installs the system 
message catalog (does not build a new one). Opens 
input file, moves the directory in the CATALOG into a 
data segment, and places the DST number and disc 
address of CATALOG in system global area. This may be 
done when the message system seems to be "broken" , but 
the catalog is intact. (MPE is issuing "MISSING MSG. 
SET=mm. MSG=nn" at terminals and at the console.) This 
may be done while the system is running. 

HELP - Used to build the HELP catalog. Reads input file and 
builds a HELP catalog ( f ormaldes ignator HELPCAT). 



15-fc 



MESSAGE SYSTEM CATALOG . PUB . SYS 



$SET 1 - SYSTEM MESSAGES (FORMER MESSAGE CATALOG) 

$SET 2 - CIERROR MESSAGES 

$SET 3 - MISCELLANEOUS ABORT MESSAGES 

$SET U - PROGRAM ERROR ABORT MESSAGES 

$SET 5 " INTRINSIC ABORT MESSAGES 

$SET 6 - RUN-TIME ABORT MESSAGES 

$SET 7 - CI GENERAL MESSAGES 

$SET 8 - FILE SYSTEM ERROR MESSAGES 

$SET 9 " LOADER ERROR MESSAGES 

$SET 10- CREATE ERROR MESSAGES 

$SET 11- ACTIVATE ERROR MESSAGES 

$SET 12- SUSPEND ERROR MESSAGES 

$SET 13- MYCOMMAND ERROR MESSAGES 

$SET Ik- LOCKGLORIN ERROR MESSAGES 

$SET 15- PRIVATE VOLUMES ERROR MESSAGES 

$SET 16- DS/3000 ERROR MESSAGES 

$SET 17- "HELP" ERROR MESSAGES 

$SET 18- GRAPHIC DEVICES ERRORS /WARNINGS /ADVISORY MSGS. 

$SET 19- SERIAL DISC ERROR MESSAGES 

$SET 20- USER LOGGING MESSAGE 

$SET 21- ASSOCIATE UTILITY 

$SET 22- PAGE PRINTER MESSAGES 
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MESSAGE SET DIRECTORY 



DST # IN SYSGLOB %373 

CAT DISC ADDR IN SYSGLOB #371-372 

CREATED BY RUNNING MAKECAT . PUB . SYS . 

KEPT IN A DATA SEGMENT AND IN A USER LABEL. 



* 

1 
2 

3 
k 

5 



17U 

175 
176 

177 
200 



DATA SEGMENT 
MAX. SET # 
# OF MESSAGE RECORDS 
RECORD OFFSET TO FIRST MESSAGE 

FIRST MESSAGE # 
RECORD OFFSET TO FIRST MESSAGE 
FIRST MESSAGE f 



EMPTY ENTRY 



RECORD OFFSET TO FIRST MESSAGE 
FIRST MESSAGE # 



RECORD OFFSET TO CURRENT MESSAGE 



MESSAGE 
BUFFER 
(6U0 WORDS) 



1U00 

EMPTY ENTRY: 

RECORD OFFSET OF NEXT IN-USE SET 
-1 



10 \ \ 
I j HEADER 

11 / 
1 




12 \ 

| | SET 1 

13 / 
i 


| USER 
j LABEL 


|U \ 

I | SET 2 

15 / 





I 
I 

|12U\ 

I | SET 62 
1125/ 
I 

|126\ 

■I | CUR MSG 
1127/ 



I 



1128 



/ 



I 

— I 

768 
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HELP SUBSYSTEM 



HELP DIRECTORY 



KEPT AS USER LABEL 
READ ONTO USER'S STACK 
USES SEARCH INTRINSIC FORMAT 
VARIABLE ENTRY SIZE 



DIRECTORY SIZE (WORDS) 



ENTRY LGTH (BYTES) | KEYWORD LGTH (BYTES) 



ENTRY 
KEYWORD 

1-255 BYTES 



ENTRY RECORD # IN CICAT 
LEFT BYTE I RIGHT BYTE 



ENTRY LGTH (BYTES) | KEYWORD LGTH (BYTES) 



ENTRY 

KEYWORD 

1-255 BYTES 



j ENTRY REC # LEFT BYTE 



ENTRY REC # R. BYTE | ENTRY LGTH (BYTES) 



KEYWORD LGTH (BYTES) | 



ENTRY 

KEYWORD 

1-255 BYTES 



ENTRY REC # 
LEFT BYTE I RIGHT BYTE 



ENTRY 



ENTRY 



/ \ 



ENTRY 
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UDC DIRECTORY 

*EXTRA DATA SEGMENT - DST # IN DB+%250 OF UMAIN STACK 
*BUILT BY INITUDC 



0123 678 15 

LT|LN|NH|NB| |TY | ENTRY SIZE 



READER RECORD NUMBER 
BODY RECORD NUMBER 
FILE NUMBER | COMMAND LENGTH 



COMMAND 

NAME 
(1-16 BYTES) 



ENTRIES 



\ LT-OPTION LIST 
LN-OPTION LOGON 
NH-OPTION NORELP 
NB-OPTION NOBREAK 
TY- 00=USER UDC 

01=ACCOUNT UDC 
10=SYSTEM UDC 

> ENTRY 



ENTRY SIZE=0 TERMINATES 
DIRECTORY 
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UDC'S COMMAND. PUB. SYS 



•RECORD SIZE = 20(10) WORDS, 6 RECORDS/BLOCK 
•KEEPS TRACK OF WHO IS USING WHAT UDC CATALOG 
•CAN BE PURGED TO DISABLE UDC'S 
•CAN BE REBUILT TO REENABLE UDC'S 

% RECORD # % FREE ENTRY 



OJlst FREE ENTRY # |0 0|NEXT FREE ENTRY #|0 

I I I I 

1| not used |1 1| ENTRY TYPE=0 |1 

I I I I 

2| MAX IN USE |2 2| |2 

I I I I 

31 # IN USE |3 

I I 

j not used | 



I I 

231 U9 





not used 




1 
1 
1 




1 

1 
1 


1 




1 


1 




1 


231 

1" 




119 
... j 



15-9 



COMMAND . FJB . SYS ( cont . ) 



% 


1 
2 

3 
U 

5 
6 

7 
10 
11 

12 

13 
1U 

15 
16 

17 
20 
21 
22 
23 



USER ENTRY 
CATALOG ENTRY # 
ENTRY TYPE=1 



USER* 



ACCOUNT* 



not used 



# 


% 


1 

2 
3 


FILE ENTRY 


# 





NEXT CAT. ENTRY # 


10 


1 


ENTRY TYPE = 2 


1 


2 
3 
k 


FILE NAME 
FOPEN FORMAT: 


2 

3 
1+ 


5 


5 




5 


6 


6 


FILE 


6 


7 


7 


[/LOCKWORD] 


7 


8 


10 


GROUP 


8 


9 


11 


ACCOUNT 


9 


10 


12 





10 


11 


13 




11 


12 
13 


lit 
15 


(UP TO 36 BYTES) 


12 
13 


1U 


16 




Ik 


15 


17 




15 


16 


20 




16 


17 


21 




17 


18 


22 




18 


19 


23 

ACCOl 




19 


fD THE 


JNT FIELD CONTAIN 


'% 



THIS INDICATES SYSTEM LEVEL UDC'S. 

IF ONLY THE USER FIELD CONTAINS € AND 7 SPACES, THIS INDICATES 
ACCOUNT LEVEL UDC'S. 
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CHAPTER 16 SYSDUMP/INITIAL 



CTABO (Memory Size Independent Configuration Values) 
RECORD OF CONFDATA FILE 



|__,-_| H --|--|--|~|--|--|"I"I--|--|--I"|--I 
01 MEMORY SIZE IN K WORDS |0 

I I 

1| CORE SIZE INDEX U 

I - — - — -- I 

21 STANDARD STACK SIZE 1 2 

I I 

31 HIGHEST DRT # 13 

I I 

Ul TERMINAL BOUND PRIORITY I 1 * 

I I 

51 NORMAL PRIORITY 15 

I I 

61 CPU BOUND PRIORITY 1 6 

I I 

71 # OF SECONDS TO LOG-ON 1 7 

I I 

10 1 LOG FILE RECORD SIZE (SECTORS) 1 8 

I I 

111 LOG FILE SIZE (RECORDS) 1 9 

1 ! 

12! LOG FILE # !10 

I I 

13| LOG BITS (ONLY 11 USED) 111 

I ! 

1U| 112 

151 «DEFINES WHAT IS BEING LOGGED» 1 13 
16| UU 

I I 

171 15 

I - I 

20 J DEFAULT JOB/SESSION CPU TIME LIMIT |l6 

1 - ! 

21 J FILES DUMPED 1 17 

1— I „ 

22 1 HIGHEST LOGICAL DEVICE # |18 

I " ""I 

23| HIGHEST VOLUME # | # OF VOLUMES I 19 

I — I 

2U| DEVICE CLASS TABLE SIZE 1 20 

I — I 

25| FIX LEVEL 121 

I— 1 
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RECORD (COST.) 



I I 

26| COLD LOAD COUNT 1 22 

I I 

271 MAX INITIAL SEGMENT SIZE 1 23 

I"—. " — I 

30 \ DISC COLD LOAD ENTRY POINT |2** 

I " - I 

31 | SIZE OF OLD VOLUME TABLE |25 

I- " I 

32 1 SIZE OF OLD INFO TABLE 1 26 

I 1 

33 1 TIME QUANTUM (unused) 1 27 

I I 

3U | MAXIMUM OPEN SPOOL FILES |28 

I - "I 

351 CSTAB SIZE |29 

I— " I 

361 130 

I MAXIMUM # OF SPOOL FILES (KILO SECTORS) | 
371 131 

I I 

1*0 1 # OF ADDITIONAL CS DRIVERS |32 

I I 

Ulj # SECTORS PER SPOOL EXTENT | 33 

i i 

U2| UPDATE LEVEL |3*» 

I I 

U3| VERSION 135 

I " I 

UU| SERIAL DISC LOAD |FD|SD|36 

I I 

U5| MIT VERSION 137 

I - I 

U6| MIT UPDATE 138 

I - - I 

l»7l MIT FIX 139 

I " I 

-///////////////////////////////////////////////"• 
-///////////////////////////////////////////////"■ 
"///////////////////////////////////////////////"• 
I — - I 

1771 RESERVED 12»» (10) -127(10) 1 127 

I - I 

SERIAL DISC LOAD (Word %kk) 

FD - Date given for sysdunp was future date 
SD - Sysdump was to serial disc 
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CTAB (Memory Size Dependent Configuration Values) 
RECORDS 1-8 OF CONFDATA 



record memory size k words 

1 - 6k 

2 - 80 This table describes the 
3-96 CTAB format in detail and is 
h - 128 typical of any record (1-8) 

5 - 160 

6 - 192 

7 - 22U 

8 - 256 and larger 

|._|..|..|__|..|..|..|.-|._|._|..|_.|..|._|._|„| 
0| # OF CST ENTRIES |0 

I I 

1| # OF DST ENTRIES |1 

I I 

2| # OF PCB ENTRIES |2 

I " "I 

31 # OF IOQ ENTRIES |3 

I I 

U| # OF TERMINAL BUFFERS |U 

I I 

51 # OF CST ENTENSION ENTRIES |5 

I - - i 

6| INTERRUPT CONTROL STACK SIZE (Ql to Zl) |6 

I-— " " I 

7| # UCOP REQUEST QUEUE ENTIRES |7 

I 1 

10 I # BREAKPOINT ENTRIES |8 

i " I 

11| # TRL ENTRIES |9 

I I 

12 I # LOCAL RINS |10 

I 1 

131 # GLOBAL RINS |11 

I — I 

lU| # OF SYSTEM BUFFERS |12 

I 1 

151 # OF CONCURRENT PROGS |13 

I — - I 

16| # OF MAM TABLE ENTRIES |lU 

I 1 

"///////////////////////////////////////////////-. 
V//////////////////////////////////////////////-. 
I I 

2U1 iiiiitiiiniiiiiiiuiiiiiuiiiiiiiiiiiiniiiiii 1 20 
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RECORDS 1-8 (CONT.) 



25J DIRECTORY SIZE (SECTORS) |21 

I I 

V//////////////////////////////////////////////-. 
-///////////////////////////////////////////////". 
"///////////////////////////////////////////////-. 
I - - I 

36 1 MAXIMUM CODE SEGMENT SIZE 1 30 

I I 

371 MAXIMUM # OF CODE SEGMENTS /PROCESS |31 

I I 

U0| MAXIMUM STACK SIZE (MAXDATA) |32 

I I 

kl I MAXIMUM EXTRA DATA SEGMENT SIZE 1 33 

I I 

U2| MAXIMUM # OF EXTRA DATA SEGMENTS /PROCESS \3k 

-///////////////////////////////////////////////". 
V//////////////////////////////////////////////-. 

"iiiiiiiuiiiiiiiiiiiuiiiiiiiiiiuiiiiiimuir- 
1 - 1 

50| MAXIMUM # RUNNING SESSIONS |U0 

I -I 

51| MAXIMUM f OF RUNNING JOBS |Ul 

I I 

52 j # LOG PROCS jU2 

I I 

531 LOG ID's |U3 

I I 

5»»| # DISC REQUEST TABLE ENTRIES \kk 

I I 

551 # SPECIAL REQUEST TABLE ENTRIES |1«5 

I - I 

56 1 f PRIMARY MESSAGE TABLE ENTRIES |U6 

I I 

571 # SWAP TABLE ENTRIES |1*7 

I I 
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DRIVER TABLE 



The Driver Table consists of 6 word entries, in correspondence to 
the LDEV entries, up to the highest LDEV used, entry zero is a 
dummy entry. 



1 2 3 U 5 6 7 8 9 10 11 12 13 l 1 * 15 



|--|"l"l"l"l"i 



DS 



DRT # 

"I I — 

CR| CHAN # | 



I 



D 
I 



N 
M 



UNIT # 
MASTER LDEV 



R 
V 



A 

E 



TYPICAL ENTRY 
FORMAT 



DS DS DEVICE (if set DRT is zero) 

CR CORE RESIDENT 

CHAN # CHANNEL # 

MASTER LDEV LDEV of device which this DS device is linked to. 

Words 2-6 contain the driver name. 
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SYSDUMP FORMAT 



READ - SIO - PROGRAM PROGRAM 
SIO PROGRAM 



ICS 
LOW CORE 



CS TABLE 
DRIVER TABLE 



LPDT 
LDT 



DEVICE CLASS TABLE 
LDTX 



VTAB 
OLDVTAB 



DISC COLD LOAD INFORMATION TABLE 
CTAB 



CTABO 
CSDVR 
CSDEF 



ININ 
TCST 



INITIAL'S DB AREA 
STACK MARKER 



INITIAL'S SEGMENTS 
RIN TABLE 

NOT DUMPED IF DATE =CARRIAGE RETURN 



■-TAPE LOAD POINT 
•-SERIAL DISC LOAD POINT 
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SYSDUMP FORMAT (CONT. ) 



DIRECTORY HEADER 



DIRECTORY 



EOF 



SYSTEM PROGRAMS, SL, NON-STD. DRIVERS 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 



STORE/RESTORE HEADER 



eof xxxxxxxxxxxxxxxx 



STORE/RESTORE DIRECTORY 



XXXXXXXXXXXXXXXXXXX EOF 



USER FILES (SEPARATED BY "EOF's") 



STORE/RESTORE TRAILER 



EOF 



EOF xxxxxxxxy xxxyxyx 



EOF 



i 



HOT DUMPED IF DATE » CARRIAGE RETURN 



NOTE: ON DISC, READ-SIO-PROGRAM KEPT IN DISC LABEL. 
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STORE TAPE FORMAT 



FIRST VOLUME 



•:♦♦:♦:♦;♦;♦:♦:♦:♦♦♦:♦;♦♦♦♦.♦ 



EOF 
EOF 



♦:♦♦♦♦♦♦;♦♦♦:♦♦♦;♦♦♦♦;♦: 



"STORE/RESTORE LABEL 
HP/3000." 



"VIIB" 



PARTIAL FIRST FILE FLAG 

CHECKSUM 
DIRECTORY INDEX OF FIRST FILE 



VOLUME NUMBER 
DATE 
TIME 



TAPEBLOCKSIZE (#WORDS/BLOCK;def=l»Q96) 




13 

lh 
15 

16 

17 
18 

19 

22 
23 

2U 

25 
26 

27 
28 

39 



HEADER 
UO WORDS 



DATE: 
0:7 last 2 digits 

of year 
7:9 Julian date 

TIME: 
25.(0:8) hours 

(8:8) minutes 
26.(0:8) seconds 

(8:8) .1 sees. 
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FIRST VOLUME (CONT. ) 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX 



FILE NAME 



GROUP NAME 
ACCT. NAME 



EOF 



FILES (separated by "EOF's") 



| TIP FILE 
j ENTRY 
|(12 WDS.) 
I 



VOLUME 
DIRECTORY: 
# ENTRIES 
DETERMINED 
BY TAFEBLOCK- 
SIZE 



\ 

| FILES 

I 
/ 
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STORE FORMAT 



SUBSEQUENT VOLUMES 



13 

lit 
15 

16 FLAG=1: 
1st FILE 

17 ON THIS 
VOL IS A 

18 PARTIAL. 

19 
22 

23 
2U 

25 
26 

27 

28 
39 

\ 

| TYPICAL 
| FILE 
| ENTRY 

/ 








"STORE/RESTORE LABEL - 
HP/3000." 


\ 


"VIIB" 




PARTIAL FIRST FILE FLAG 




CHECKSUM 




DIRECTORY INDEX OF FIRST FILE 


| HEADER 
j UO WDS. 




VOLUME NUMBER 




DATE 




TIME 




TAPEBLOCKSIZE 




• 


/ NOTE: NO EOF 
\ 


FILE NAME 




GROUP NAME 


| VOLUME 
| DIRECTORY 


ACCT NAME 


• 





EOF xxxxxxxxxxxxxxxxxxx 



<FILES> 
(separated by "EOF's) 



FILES 
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STORE FORMAT 



END OF VOLUME 



:♦:♦♦:♦♦♦♦:♦♦♦♦♦:♦♦.♦♦♦*♦ 



<FILES> 
(separated by "EOF's) 



EOF 



■♦:♦:♦♦♦:♦:♦♦;♦;♦♦♦.♦.♦♦.♦,♦.• 



"STORE/RESTORE LABEL -HP/3000 . " 



FLAG: PRECEDING EOF MARKS FILE ENDED 



FLAG: PRECEDING EOF MARKS TAPESET ENDED 



VOLUME NO. 



DATE 



TIME 



;♦♦♦>♦;♦♦♦:♦♦♦.♦♦♦♦♦♦♦. 



EOF XXXXXXXXXXXXXXXXXX 



:♦♦:♦:♦»;♦>;♦;♦:♦;♦;♦;♦ ♦;♦,♦♦♦ 



EOF 



XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX 




13 

Ik 

20 

21 

22 

23 
2U 

25 
26 

27 

39 



I FILES 

! 
/ 



TRAILER 
UO WDS. 
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CHAPTER 17 MISCELLANEOUS 



Labeled Tape Subsystem 

The MPE labeled tape subsystem permits convenient access to tapes 
labeled to either ANSI or IBM standards. It operates as a set of 
subprocedures to the file system. 

A labeled tape consists of one or more logical files. Each logical 
file consists of three physical files, i. e. tape areas delimited by 
tapemarks. The first physical file contains header labels, the second 
contains the data, and the third contains trailer labels which are 
(except for minor differences) copies of the header labels. The tape 
mark following trailer labels will be followed either by header labels 
for the next file, or by another taperaark if there is no next file. 
Labels are 80 bytes long, and conventionally are identified by their 
first four characters (three letters and a digit) as follows: 

V0L1: Present only on the first file of a volume, the volume label 
contains the volume identifier, which is usually the number on the tape 
strap, and is thus not expected to be changed. 

UVLn: User volume labels. May be present on tapes from foreign shops, 
but are not written by MPE. If encountered, they are ignored. 

HDR1: First header label. Required for each file. Specifies: 

File name, 17 bytes. If the tape was not written on the HP 3000, 
only the first 8 are significant. 

Volume set identifier, 6 bytes. Names the volume on which the 
set of files begins. 

Reel number, 4 digits. Starting with 1, counts the reels containing 
this file. 

File sequence number, 4 digits. Starting with 1, counts the files 
in the entire set of files. 

Creation date, 5 digits. Year and day within year when file was 
written. 

Expiration date, 5 digits. Year and day within year when file may 
be overwritten without explicit permission. 

HDR2: Second header label. Although defined by the standard, may be 
missing on foreign tapes. Contains: 

Record format, 1 character: F if fixed length records, U if undefined 
length, V if variable length records with HP-style 2-byte binary 
byte count. Foreign tapes may have D for variable 4 _ byte decimal 
byte count; these are treated as Undefined since MPE block management 
can't deal with this format. 
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Block size, 5 digits. Length in bytes of blocks in data area. 

Record size, 5 digits. Length in bytes of records within blocks. 
Significant if fixed-length records. 

Lockword, 8 characters. An HP feature. 

File type, 1 character. A if ASCII, B if binary. HP feature. 

Carriage control, 1 character. C if file is CCTL, else blank. 
HP feature. 

User header labels: optional. Standard prescribes UHLn in the first 
four characters, but MPE doesn't care. 

E0V1: End of Volume; used as first trailer label. Required if the 
logical file is continued onto another reel. Identical to HDR1, except 
contains the number of physical blocks of data in the data area. 

E0V2: Defined by the standard, but may be missing on foreign tapes. 
Follows E0V1; format same as HDR2. 

E0F1: End of File; used as first trailer label. Required if this is 
the end of the logical file. Format same as E0V1. 

E0F2: Same as E0V2 except used after E0F1. 

User trailer labels: optional. Standard prescribes UTLn in the first 
four characters, but MPE again doesn't care. 



Tape Label Table 

The tape label table is the private playground of the tape label 
subsystem. It consists of two parts: LDEV Control Blocks (LCBs) and 
Volume Control Blocks (VCBs). The LDEV area is set up at system 
initialization and contains one entry for each magnetic tape LDEV in the 
system. As is common in MPE, the first entry is a dummy which tells 
where the other things in the table are. The volume area contains one 
entry for each labeled tape volume requested or active on the system. 

Although table entries are stored in an extra data segment, 
they are generally manipulated via local copies on the stack. The 
procedures GETLDEV and GETFNUM look for LDEV and volume entries as 
specified; they copy them to stack buffers and return the DST address 
for use in copying them back. POSTVTENT copies the entries back, and 
in the case of a new volume entry, allocates space for it in the 
volume section of the tape label table. 
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The overall structure of the TLT is: 
TLTDST — J632, #26 TLTSIR — %47,#39 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
Table initialization word (=1 when initialized) 



Entry size (ESIZE) = X32, #26 

Table relative pointer to base of LCB entries (LTBASE) 



Table relative pointer to base of VCB entries (VTBASE) 
Table relative pointer to top of Volume table (VTTOP) 
Size of Tape Label Table, in words (VTMAX) 



not used 



LDEV Control Block area — one entry/mag tape drive 



Volume Control Block table 



contains VCB entries 
and free entries 



Area available for expansion of VCB table 




1 
2 
3 
4 
5 
6 
7 
10 



30 
31 
32 <- LTBASE 



<- VTBASE 



<- VTTOP 
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The LCB entries have the following structure: 

1 2 3 4 5 6 7 8 9 10 11 12 13 M 15 

| | Type | | L | B I HP| I 

| 

| Logical device number I 1 

| | 

| VCB address I 2 

| | 

| Reel number I 3 

I 

| File sequence number I 4 

I 1 

| Creation date I 5 

, 1 

| Expiration date I 6 

7 

I 

| File name I 10 

I 



! 

I + 

17 

I i 20 

I 

t I 21 

| (not used) 

| I 22 



I 



23 



! f 24 

I 

| Volume set identifier I 25 

J 

| I 26 

27 

| Volume identifier I 30 

I I 

I I 31 

, . 1 
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Type: 00 = no tape mounted 
01 = unlabelled 

10 = ANSI 

11 = IBM 

L: 1 if file has lockword. 

B: 1 if tape is from Burroughs, which has incorrect block/record size 

in the HDR2 label. Code can be patched to correct the size. 
HP: 1 if tape is Hewlett-Packard ANSI format. 

VCB address: Pointer to VCB entry describing volume mounted on 
tape drive, only if linked. Otherwise, 0. 
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The VCB format is: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

A | F | | Position | H | SeqTypI LblTypI L ! M | R | B | 

LDEV # | 1 

PIN I 2 

File number (AFT index) I 3 

File sequence number I 4 

S | R | D | Density | V | | Reel number | 5 

Expiration date I 6 



7 
File name | 10 



16 

+ 

I I 17 



Lockword 



20 
21 
22 
23 
24 

Volume set identifier | 25 

26 

27 

Volume name I 30 

31 



17 -4b 



A: ASCII FOPTION 

F: Flush bit - operator did REPLY <pin>,0. 

Position: Gives head position within logical file. 

= at load point (LDPNT) 

1 = HDR1 label next (H1NX) 

3 = after HDR2 label (AH2) 

4 = after user header labels (AHU) 

6 = data next (DNX) 

7 = after data (AD) 

8 = E0F1/E0V1 label next (T1NX) 

10 = after E0F2/E0V2 label (AT2) 

11 = after user trailer labels (ATU) 
W: Write access specified. 

SeqTyp: File open sequencing type. 

= match filename 

1 = NEXT 

2 = ADDF 

3 = use file sequence number 
LblTyp: As in LCB entry. 

L: Linkwait - mark left by CREATETLTENT for LINKLABEL. 

U: Mount wait - waiting for operator to mount tape on FOPEN. 

R: Reelswitch wait - waiting for next reel. 

B: Busy bit - this entry is in use. 

LDEV #: Logical device number of tape drive with this volume, only if 
linked. Otherwise, 0. 

S: STORE tape. 

R: REELSWITCH has been done. Used by STORE/RESTORE to handle STORE 
label and directory file. 

D: Next file is directory. Used by STORE. 

Density: volume set density. During a volume set open, contains the 

density requested by the user in FOPEN. Once the volume set is 
open, contains the actual density of the volume set. Only 
valid for tapes on variable density tape drives. 

= default density for volume set open 

1 = 1600 BPI 

2 = 6250 BPI 

V: 1 if volume set is being opened. Reset after completion of FOPEN. 
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Volume Recognition 

Volume recognition is the responsibility of DEVREC, which reads the 
first record of a newly-raounted tape on an unowned drive and passes 
the record to AVREC. AVREC may see: 

V0L1 in the first 4 bytes, in ASCII, in which case the tape is ANSI; 
V0L1 in the first 4 bytes, in EBCDIC, in which case the tape is IBM; 
Anything else, in which case the tape is considered unlabelled. 

If the tape is unlabelled, AVREC reports to DEVREC that no further 
action is required. If the tape is labelled, AVREC wants to see the 
first HDR1 label, so asks DEVREC to read another record. (Unfortunately, 
DEVREC cannot be stopped long enough for AVREC to do its own read.) 
When the HDR1 record is found, the volume entries can be searched to 
see if there is a pending request for this volume. If so, the waiting 
process is restarted. 

If the system has been restarted with tapes mounted, there will not 
be interrupts to alert DEVREC. The procedure RECOGNIZE is called 
when needed to see if any such tapes exist. 



Opening a File 

FOPEN gets into the tape label code in three different places. The 
first is to call CREATETLTENT , which parses the string passed in the 
FORMSMSG parameter to identify the labeled tape file required. If 
there is no existing corresponding entry in the volume area, this is 
a volume set open, and a new volume entry is created. There may be 
an existing entry (if the tape was FOPENed and FCLOSEd with disposition 
2 or 3), in which case there is an associated LDEV entry for the drive 
on which the tape was left mounted by the prior operation; in this 
case, the new information is stuffed into the existing volume entry. 
A bit (LINKWAIT) is left set to mark the entry for LINKLABEL. 

The second entry is through LINKLABEL, which is called from ALLOCATE. 
At this time, it is necessary to identify the LDEV to be used for the 
tape. If no LDEV is associated, the LDEV entries are searched to see 
if the operator has already mounted the required tape; if so, the 
volume and LDEV entries are crosstied and LINKLABEL is done. If the 
search turns up nothing suitable, the operator is requested to mount 
the appropriate tape, and the procedure waits for either a REPLY or 
for AVREC to discover the appearance of a suitable tape and restart 
the process. If the operator enters a reply, it is validated. 

The third entry is through POSITION, which is responsible for 
positioning the tape to the requested file. At the file, the HDR1 
and HDR2 label are examined as required to determine the file 
characteristics . 

Reading and Writing Files 

All procedures which move tape go through the catchall procedure 
CHECKOL, which takes care of necessary labeled tape doings. The 
code insures that the sequence: header labels (including user 
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labels), data, trailer labels (including user labels) is maintained. 
There is a separate CASE leg for each such procedure. 

If an EOT reflective mark or an EOF in data is found, REELSWITCH 
is called (principally from the file system procedure IOMOVE) to 
call for the next reel, if any. If another reel is needed, the tape 
drive is set Unowned so that AVREC will be called to recognize the 
new tape when it is mounted. REELSWITCH returns to its caller when 
it is satisfied that an appropriate tape is mounted. 

Closing Files 

FCLOSE calls CHECKUL to handle writing E0F1 and E0F2 if needed and 
resolving the tape position. If the disposition is 3, the tape is 
left positioned at the next file. If the disposition is 2, the tape 
is supposed to be left at the beginning of the current file, but the 
code does not presently provide for reelswitching if the present file 
began on a prior reel. (Someday we'll get an SR on this.) 

At present, ensuing volumes of a multi-volume set must be mounted 
on the same drive as the first, mostly because neither the file 
system nor STORE-RESTORE was capable of dealing with LDEV changes 
in the middle of a file. REELSWITCH reports the LDEV being used, 
however, so that the capability of using a different LDEV can be 
added in the future. 

STORE-RESTORE 

Complications ensue on labeled STORE-RESTORE tapes because there 
needs to be a file directory at or near the beginning of each tape 
of a mult i -volume set; RESTORE uses this directory to determine 
whether the specified file(s) can exist on this tape. Because the 
reel switching process would otherwise be invisible to STORE-RESTORE, 
special bits (VCE'RSWDONE and VCB'WRITDIR) are kept to enable special 
intrinsics callable by STORE-RESTORE to report whether a directory 
needs to be written or is about to be encountered. 

The special procedure NEXTTAPEFILE is used by STORE-RESTORE in lieu 
of doing a FCLOSE (, 3) followed by an FOPEK to get to the next file. 
This permits cleaner handling of both REPLY and Forward Space 
(logical) File over a Reelswitch, as well as saving the time needed 
to tear down and reconstruct all the control blocks. 

Miscellany 

FVOLID is used by the SHOWDEV command processor (in SPOOLCOMS) to 
obtain the name of the volume on the specified drive without having 
to know the structure of the tape label table. For the same reason, 
TGETINFO is used by the FFILEINFO intrinsic (in FILEIO) to get labeled 
tape information. 
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BREAK POINT TABLE 
DST = 30(10) = %$6 
The break point table is divided into 2 sections: 

1) PCB BREAKPOINT EXTENSION TABLE (PCB'BKPT'EXT) 
This table contains the heads of the breakpoint 
chains 

2) BREAKPOINT ENTRY TABLE (BKPT "ENTRY 'TAB) 
This table contains the actual entries 

General Layout 



PCB(7).(8:8) 
I I 



%H 



SYS GLOBAL 

1U:15 

I :L:S| 



PCB'BKPT'EXT 



I I 
I I 
I I 



I I 

I |-V\-\-\-\-\-\-\-\-\ 

I I 



| BKPT' ENTRY* TAB 



I I. 



I I 
I I 

I I 



L = Table locked 

S = System break 

points exist 
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PCB BREAKPOINT EXTENSION TABLE 



# ENTRIES 
HEAD SYSTEM LIST 
# USED USER ENTRIES 



USER ENTRIES 



ENTRY SIZE = 1 

FREE ENTRY = 

ACTIVE ENTRY = Index 1st Entry 
in breakpoint 
chain 
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BREAKPOINT ENTRY TABLE 







ENTRY (0) 




FREE ENTRY 







l# 
1 


WORDS BREAKPOINT TAB | 
HEAD FREE LIST | 


|1: 


SIZE 




1 




FORWARD LINK 




2 


1 
1 

1 
1 

! 


1 
1 

UNUSED | 
1 
1 




BACKWARD LINK 




3 
1* 


- 




- 






LAST ENTRY 







1 


11 









The breakpoint entry table consists of variable length entries 
The minimum entry size is 5- 

ACTIVE ENTRY 

0|1:2:3|>»:5:6|7:8:9|0:1:2|3:U:5 



o ! 


0|P:L:V|D:F:T|U:P:C|U: SIZE | 
| : : | : : | :M: |P: | 




l 1 


BLOCKLABEL 




2 1 


PLOC 




3 


INSTRUCTION 




k 


LINK 






USERLABEL 


• 




CONDITION/COUNT 


variable 




| COND DESCRIPTOR 


1 • 
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BREAKPOINT ENTRY TABLE (CONT.) 



ENTRY (0) 
ENTRY (0) 
ENTRY (0) 
ENTRY(0] 
ENTRY(O) 

ENTRY(O) 
ENTRY(O) 
ENTRY(O) 
ENTRY (0] 
ENTRY(O) 
ENTRY(0] 

ENTRY(U) 



0:1) 


= FR: 


1:1) 


= P: 


2:1) 


= L: 


3:1) 


= V: 


U:l) 


= D: 


5:1) 


= F: 


6:1) 


= T: 


7:1) 


= U: 


8:1) 


= PM: 


9:1) 


= C: 


10:1) 


= UP 



= LINK: 



FREE ENTRY 
1 = FREE 

= USED 

PRIVILEGED MODE BREAKPOINT 

1 = PRIV. 

= NON-PRIV 
PROCESS -LOCAL BREAKPOINT 

1 = PROCESS-LOCAL 

= SYSTEM 
VALIDATION BIT 

1 = INSTRUCTION IN ENTRY (3) 

= INSTRUCTION NOT IN TAB. 
DOUBLE TRAP 

1 = BREAKPOINT OSCILLATES BETWEEN 

P/P+l 

= NOT DOUBLE TRAP 
FAKE 'DUMMY' TRAP 

1 = BREAKPOINT AT P+l 

= BREAKPOINT AT P (ORIG. LOC) 
TWO WORD INSTRUCTION 

1 = TWO WORD INSTRUCTION 

■ NOT TWO WORD INSTRUCTION 
USER LABEL PRESENT 

1 - TRAP TO USER SUPPLIED LABEL 

= TRAP TO DEBUG 
PERMANENT BREAKPOINT 

1 ■ PERM 

= TEMPORARY 
CONDITION/COUNT 

1 = CONDITION/COUNT SPECIFIED 

= NO COND/COUNT 
UPDATING 

1 = ENTRY IN PROCESS OF BEING 

UPDATED/REMOVED 
- NOT BEING UPDATED/REMOVED 
LINK 

= END OF CHAIN 
>0= INDEX NEXT ENTRY 
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BREAKPOINT ENTRY TABLE (CONT.) 
COUNT CONDITION 

1) | ORIGINAL CNT. | 2) | OPERANDI 
| # OF HITS | | OPERAND2 
| 1 j |OPTliOPt2| RELOP 



RELOP -> (8:8) RELOP NUMBER: 

3 = LT 9 = LTE 
U = GT 10 = GTE 
5 = EQ 11 ■ NEQ 
OPT1 -> (0:2) OPERANDI 'S TYPE 
OPT2 -> (2:2) OPERAND2'S TYPE 

OPERAND TYPES: 

-> CONSTANT (SINGLE WORD) 

1 -> ADDRESS (DOUBLE WORD) 

3 -> INDIRECT ADDRESS (TRIPLE WORD) 

OPERAND FORMS: 

CONSTANT -> 



| CONST 



ADDRESS 



REG 



| REG | BASEl 
| OFFSET | 
|IND. OFFSET | (TYPE 3 ONLY) 



-> (0:6) CORRESPONDING INDEX INTO 'REGY' 
3 = A 10 = DL 



BASE 



u 


= SY 


11 = 


Q 


7 


= DA 


12 = 


S 


8 


= DX 


17 - 


EA 


9 


= DB 






> (6:10) SEG l/BANK # 
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UCOP REQUEST QUEUE (DST#9) 



MAX# REQ ENTRIES N/2 



1| 
21 



DOUBLE POINTER TO NEXT AVIL 
DOUBLE POINTER TO NEXT REQ 



N 

WRDSl 



REQ 1 
REQ 2 



REQ N 
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UCOP ENTRY FORMAT Request Codes 

null 

1 null 
12-15 

I " 1 

I /////////////////////////////////// I 2 | 

| 1 2 process deletion 

I /////////////////////// I PIN ! 
I I 

0-7 8-15 

7 12-15 

I— - I 

I RANKSQ I ///////////I 3 I 

j 1 3 priority change 

| NEW PRIORITY | PIN | 

I " " I 

8 12-15 

I— I 

|+- #SECTORS I //////// I U | 

j ________ _ __| lj dl change 

I /////////////////////// I PIN I 
I " I 

8 12-15 

I I 

|+- #SECTORS I //////// I 5 I 

j 1 5 z change 

I /////////////////////// I PIN I 



8 12-15 
j ! 

|+- #SECT0RS I //////// I 6 j 

j 1 6 PCBX size change 

I IIIIUIIIIIIIIIIIIIIIIIII I PIN I 
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TIMER REQUEST LIST (TRL) 



The system clock interrupts every 100 ms, with the CR being 
automatically cleared. An exception is the Shared Clock 
Interface measurement service which allows rates as fast as 5 ms 
The interrupt handler is the procedure TICK. On entry, DB is 
pointing to the base of timer request list. Besides timeout 
requests, the clock also controls time slicing. 



/ 
I 

I 1 
ENT0| 
I 2 
I 
\ 3 

/ u 

I 

I 5 
I 
ENT1| 6 



\ 7 

/ 8 
I 
I 9 

1 

1 10 

I 
Ml 

/12 
I 

U3 



ENT2I 



EHT3I 



FREE LIST PTR 
NR ENTRIES | ENTRY SIZE(U) 



TRACE WORD 

# of days since last start 

QUANTUM/100 ms 



TIME OF DAY* 



YEAR | JULIAN DAY 
PTR TO MOST ACTIVE REQUEST 









A| CODE | PTR TO NEXT 



REQ 



TIME TO SERVICE AFTER 
REQUEST IN FRONT (UNIT= 100ms) 



A: if inactive request 
1 if active request 



Series 30/33 only 
QTIME 

DTIME* 



HEAD 



dummy time 



I 
assignable 
entries 
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TRL (CONT.) 



& REQ 


indicate the type of 


request. 


CODE: 


REQ: 


TYPE: 





DITP 


Hangup 


1 


DITP 


Carrier failure 


2 


DITP 


202 turnaround 


3 


DITP 


Read 


4 


DITP 


Logon 


5 


PCBB index 
to process 


Delay 


6 


DITP 


LP not ready 


7 


DITP 


2640 


%10 


Port mask 


Usg port timeout 


JU1 


DITP 


Block mode read 
timeout (30 sees) 


%12 


PCBB index 


Watchdog timer for 




to process 


process 



The list of pending requests is kept ordered by time with later 
entries at the tail. 



%20-%37 



DITP 



SIO device timeout: 
DIT8. (code_l on 
expiration, cleared 
on Timereq. 



%5/%6 



*DTIME 



For Series 30/33, DTIME is 
# of TICS (0.091457 ms) 
since last midnight. 
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USER LOGGING TABLE 



ENTRY SIZE = 36 
DST %33 



FIRST ENTRY 



0. 
1. 

2. 
3. 
k. 

5- 
6. 

7. 
8. 

9. 

10. 

11. 

12. 

13. 

Ik. 

15. 

16. 

17. 
18. 
19. 



| NUMBER OF ENTRIES | 
i 1 1 


| FREE ENTRY HEAD FT. 1 


| INUSE ENTRY HEAD FT. | 
1 I 1 


| NEXT BUFFER NUMBER | 



































n-ik 



USER LOGGING TABLE (CONT) 



20. 
21. 
22. 

23- 
2k. 

25- 
26. 

27. 
28. 

29- 
30. 

31. 
32. 
33. 
3U. 
35- 

































1 1 1 

1 1 1 



17-15 



USER LOGGING TABLE (CONT) 



NUMENTRIES 
FREE 
INUSE 
BUFNUM 



LOGTAB 
LOGTAB(l) 
LOGTAB(2) 
LOGTAB(3) 



NUMENTRIES 

The number of entries in the logging table. 

FREE 

A table relative pointer to the first free entry in the logging 

table. 

INUSE 

A table relative pointer to the first entry in the logging table 

that is being used. 

BUFNUM 

The number of the buffer associated with this logging process. 
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USER LOGGING TABLE (CONT) 







TYPICAL ENTRY 




o. 1 








1. 1 


— 


LOGGING 




2. 1 


— 


IDENTIFIER 


— ! 


3. 1 


■■ 


1 
1 


■~ a 


k. 1 








5- 1 


— 


BUFFER 




6. 1 


— 


NAME 


— ! 


7. i 


"■ 


1 


~~ i 


8. 1 








9- 1 


— 


PASS 




10. 


— 


WORD 


— | 


11. 


•• 


1 


" * i 


12. 








13- 


- 




= , 


1U. 


- 




— J 


15- 


- 


LOG 


- 


16. 


- 




— [ 


17. 


- 


FILE 


- 


18. 


- 




—J 


19- 


i — 

i 


NAME 


i 
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USER LOGGING TABLE (CONT) 



20. 
21. 
22. 
23. 
2k. 

25- 
26. 

27. 
28. 

29- 
30. 

31. 
32. 

33. 
3U. 
35. 



I 



NUMBER OF USERS 



BUFFER DST NO 
I 



LOG TYPE 



LOG DEV 
I 



LOG PCB # 
I 



SPARE 
SPARE 



LOG STATUS 



1 



FWRD ENTRY FT 
I 



BKWRD ENTRY FT 
I 
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USER LOGGING TABLE (COMT) 



TABINDEX 
TABINDEX 
BTABINDEX 
DTABINDEX 

LGNAME 

BNAHE 

PWORD 

LFGROUP 

LFACCT 

NUMUSERS 

DST 

LGT7FE 

= TAPE 

1 = DISC 
LGDEV 

PIN 

STATUS 

ACT = 1 

INACT = 

RECOVERING = 

NEXT 

PREV 



WORD INDEX TO CURRENT ENTRY 
BYTE INDEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 

BTABINDEX 

BTABINDEX+8 

BTABINDEX+16 

BTABINDEX+32 

TABINDEX+UO 

TABINDEX+2U 

TABINDEX+25 

TABINDEX+27 



TABINDEX+28 
TABINDEX+29 
TABINDEX+26 



TABINDEX+36 
TABINDEX+37 



LGNAME 

The name of the logging process (logging identifier). 

BNAHE 

The name of the disc buffer used if the logging process 
destination file is a tape file. This is a file that resides 
in PUB. SYS. The format of the name is ULOGxxxx where xxxx is the 
buffer number padded on the left with zeroes. 

PWORD 

The password of the logging identifier. 

LFGROUP 

The group that the destination logging file resides in if the 

file is a disc file. 

LFACCT 

The account that the destination logging file resides in if the 

file is a disc file. 
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USER LOGGING TABLE (CONT) 



NUMUSERS 

The number of users currently accessing the logging file. 

DST 

The dst number of the logging data segment. 

LGTTPE 

The type of destination file of the logging process. Either disc 

or tape. 

LGDEV 

The logical device number of the destination file. 

PIN 

The process identification number for the logging process. 

STATUS 

The status of the logging process 

NEXT 

A table relative pointer to the next entry in the logging table. 

PREV 

A table relative pointer to the previous entry in the logging 

table. 
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USER LOGGING BUFFER 



ENTRY SIZE = 25 



1 COMMUNI 


NATIONS 


AREA 










I ENTRY #2 






|FPT!BPT| 
1 1 1 


I ENTRY #3 






|FPT|BPT| 
1 1 1 


I ENTRY #U 






|FPT|BPT| 
1 1 1 




I ENTRY IN 






|FPT|BPT| 

I 1 f 


j BUFFER AREA 
I UK WORDS 







USER LOGGING BUFFER (CONT) 





ENTRY #0 


0. 

1. 


LOG | 
ADDRESS 


2. 
3. 


INPUT | 
RECORD 1 


5. 


FILE | 
SIZE 


6. 

7- 


FILE | 
SPACE | 


8. 
9- 


TOTAL 1 
RECORDS 


10. 


1 1 


11. 


LOG FILE ( 


12. 


NAME f 
1 1 


13. 


1 1 


Ik. 


1 I 


15- 


SPARE | 
1 1 


16. 


SPARE | 
1 1 


17. 


SPARE | 


18. 


SPARE | 
1 1 


19- 


SPARE | 
1 1 


20. 


SPARE | 
1 1 
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USER LOGGING BUFFER ( 






21. 


SPARE | 
1 1 


22. 


SPARE | 
1 I 


23. 


SPARE | 


2U. 


SPARE 




ENTRY #1 


0. 


NUMBER OF USERS | 
1 1 


1. 


LOGGING DEVICE # | 


2. 


1 1 


3. 


BUFFER SPACE j 
1 1 


l». 


SLEEP COUNT | 
1 1 


5- 


NEXT USER NUMBER | 


6. 


LOG PROCESS PIN ] 


7. 


1 1 


8. 


BUFFER NUMBER j 
1 1 


9- 


LOGGING TYPE \ 
1 1 


10. 


IN USE HEAD PT | 
1 1 


11. 


FREE HEAD PT | 
1 1 


12. 


OPERATOR MSG | 
1 1 


13. 


LOG PROCESS MSG | 


lU. 


USER PROCESS MSG | 
1 1 


15- 


MAX USERS | 

i i 
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USER LOGGING BUFFER (CONT) 



16. 


1 
RESOURCE 

1 


18. 


1 

1 


19. 


SPARE 


20. 


SPARE 

1 


21. 


SPARE 

1 


22. 


SPARE 

1 


23. 


SPARE 

1 


21*. 


SPARE 
1 



WORD ENTRIES 



LOGADDR 

LOGTYPE 

DISC 

TAPE 

STATE 

HUHUSERS 

LOGDEV 

BSPACE 

BHUM 

SLPCT 

USERNO 

LOGPIN 

TYPE 

UHEAD 

FHEAD 

HSG 

IMMSG 

OUTMSG 

MAXUSERS 





1 



LOGBUFF(O) 
LOGBUFF(23) 



LOGBUFF(23) 
LOGBUFF(25) 
LOGBUFF(26) 
LOGBUFF(28) 
LOGBUFF(33) 
LOGBUFF(29) 
LOGBUFF(30) 
LOGBUFF(3D 
LOGBUFFb 1 *) 

LOGBUFF(35) 
LOGBUFF(36) 

LOGBUFF(37) 
LOGBUFF(39) 
LOGBUFF(38) 
LOGBUFF(UO) 
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USER LOGGING BUFFER (CONT) 



DOUBLE ENTRIES 



INBUFREC 

FSIZE 

FSPACE 

TRECS 

RESOURCE 



DLOGBUFF(l) 
DLOGBUFF(2) 
DLOGBUFF(3) 
DLOGBUFF(U) 
DLOGBUFF(21) 



BYTE ENTRIES 

LOGFILENAHE = BLOGBUFF(20) 
LOGADDR 

The disc address of the logging destination file if the file is 
on disc. If the file is on tape, this is the disc address of the 
disc buffer for the file. 

INBUFREC 

The record number of the next block to be written to the logging 

destination file or the disc logging buffer for tape file. 

LOGTYPE 

The type of destination file for the logging process. This can 

be disc or tape. 

STATE 

The state of the user process accessing the logging file. This 

can be either active or inactive. 

NUMUSERS 

The number of users currently accessing the logging file. 

LOGDEV 

The logical device number of the destination logging file. 

FSIZE 

The current extent size of the logging destination file or disc 

logging buffer file for tape destination files. 
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USER LOGGING BUFFER (CONT) 

BSPACE 

The amount of space in records that remains in the memory logging 

buffer . 

BNUH 

The buffer number of the disc buffer for tape destination logging 

files. 

FSPACE 

The space in records that remains in the current extent of the 

disc logging destination file or disc buffer for tape destination 

files. 

SLPCT 

The number of users accessing the logging file that are waiting 

to be activated by the logging process. 

USERNO 

The next sequential number to be assigned users accessing the 

system. 

LOGPIH 

The process identification number for the logging process that 

services request for this logging file. 

LOGFILENAHE 

TRECS 

The total number of records written to the logging destination 

file. 

UHEAD 

A table relative pointer to the first entry into the logging 

data segment 

FHEAD 

A table relative pointer to the first free entry in the logging 

data segment. 

MSG 

A message word for messages coming from the operator. 
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USER LOGGING BUFFER (CONT) 



IKMSG 

A message word for messages coming from the user process. 

OUTMSG 

A message word for sending messages to the user process. 

RESOURCE 

A double word used for resource management through the procedures 

obtain and release. 

MAXUSERS 

The maximum number of users allowed to access the logging file. 



1 7-07 
— i £ i 



TYPICAL LOGBUFF ENTRY 



o. ] 






1- 1 


LOGGING 




2. I 


IDENTIFIER 


— 


3. 1 


1 


— i 


U. ! 


1 




5- ! 


USER 


— 


6. 1 


NAME 


— 


7. ! 


1 


™~i 


8. ! 






9. 


- 


- 


10. 


GROUP 


- 


11. 


1 


— 1 


12. 


1 




13- 


- 


- 


1U. 


ACCOUNT 


- 


15- 


1 


■"■ a 


16. 


TOTAL | 


17. 


RECORDS | 


18. 


| WAIT STATE | 
1 1 1 


18. 


| USER' PCB # | 
I 1 1 


19- 


! LOG NUMBER | 
1 1 1 


20. 


| ERROR CODE | 
1 1 1 
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TYPICAL LOGBUFF ENTRY (CONT) 







21. 


SUBSYSTEM CODE | 
1 1 


22. 


FRWD ENTRY FT | 
1 1 


23. 


BKWRD ENTRY FT | 
1 1 


2U. 





BINDEX 

INDEX 

DINDEX 

LOGID 

USER 

GROUP 

ACCT 

RECS 

WSTATE 

» INACT 

1 « ACT 
UPIN 
LGNUM 
ERROR 
SCODE 
NENTRY 
PENTRY 



BYTE INDEX TO CURRENT ENTRY 
WORD INDEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 

BINDEX 

BINDEX+8 

BINDEX+16 

BINDEX+21* 

DINDEX+8 

INDEX+18 



INDEX+19 
INDEX+20 
INDEX+21 
INDEX+22 
INDEX+23 
INDEXT+2U 



LOGID 

The name of the logging identifier for the logging process. 

USER 

The name of the user who opened the logging file through this 

entry. 

GROUP 

The group of the user who open the logging file. 
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TYPICAL LOGBUFF ENTRY (CONT) 



ACCT 

The account of the user who open the logging file. 

RECS 

The number of records written by this user. 

WSTATE 

The wait status of the users process. This is either waiting or 

not waiting 



UPIH 

The process identification number for the user's process. 

LGNUM 

The logging number assigned to the user. 

ERROR 

Used to hold error information for this user. 

SCODE 

The subsystem code for the caller. This applies only to 

privleged callers. 

HENTRY 

A table relative pointer to the next entry in the logging data 

segment . 

PENTRY 

A table relative pointer to the previous entry in the logging 

data segment. 
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LOGGING IDENTIFIER TABLE 



ENTRY SIZE = 33 




DST %Ul 


ENTRY #0 




o. 1 


1 




i. r 


LOGGING 


— . 


2. 1 


IDENTIFIER 


— . 


3. r 


1 




J*. ! 


1 




5. f 

6. f 


PASSWORD 


- 


7. r 




"j 


8. ! 


1 




9. r 


FILE 


— . 


io. r 


NAME 


— i 


ii. r 


1 


■™ * 


12. | 


1 




13. f 


FILE 


— , 


iu. r 


LOCK WORD 


— - 


15. r 


1 


™* | 


16. ! 


1 




17. r 


FILE 


— . 


is. r 


GROUP 


■ 
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LOGID TABLE (COST) 



19. 


- 




- 


20. 




1 




21. 


— 


FILE 


— 


22. 


— 


ACCOUNT 


— 


23. 


"" 




— . 


2k. 




1 




25. 


— 


USER'S 


- 


26. 


— 


NAME 


— j 


27. 


■h 


1 


■™i 


28. 




1 




29. 


— 


USER'S 


— ! 


30. 


— 


ACCOUNT 


— } 


31. 


"~ 


1 


■™i 


32. 


ENTRY STATUS 

1 1 



WORD ENTRIES 



NENTRIES 

MENTRIES 
FENTRIES 



LIDTAB(O) 
LIDTAB(l) 
LIDTAB(2) 
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LOGID TABLE (COHT) 



BYTE ENTRIES 

LID = BLIDTAB 

PW » BLIDTAB(8) 

FNAME - BLIDTAB (16) 

LW ■ BLIDTAB (2U) 

FGROUP = BLIDTAB (32) 

FACCT = BLIDTAB (UO) 

UNAME = BLIDTAB (1*8) 

UACCT = BLIDTAB (56) 



NENTRIES 

The number of entries in the table. 

MENTRIES 

The maximun number of entries in the table. 

FENTRIES 

The number of free entries in the table. 

LID 

The logging identifier name. This is a maximum of eight 

characters long. 

PW 

The pass word for the logging identifier. This is a maximun of 

eight characters long. 

FNAME 

The name of the destination file. 

LW 

The lock word on the destination file if the file is on disc. 

FGROUP 

The group that the file resides in. 

FACCT 

The account that the destination file resides in. 

UNAME 

The name of the user who created the logging identifier. 

UACCT 

The account of the user who created the logging identifier. 
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LOGID TABLE (CONT) 



0. 
1. 
2. 



ENTRY #1 
ENTRY SIZE = 33 

NUMBER OF ENTRIES 



|MAX NUMBER OF ENTRIES| 

I 



T 



I 



DOUBLE ENTRIES 



NENTRIES 
MENTRIES 



DLIDTAB(O) 
DLIDTAB(l) 



The number of entries in the table. 

MENTRIES 

The maximum number of entries in the table. 
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LOGGING RECORD FORMAT 



RECORD SIZE = 128 WORDS 
USER AREA = 117 WORDS 



LOG RECORD AT OPENLOG 

2 3 U 6 7 11 12 24 
127 128 



i — T~ I II I II ii 

| rec#|cksum|code | time | date | logid|log#| creator Ipcb | 
| I I I I I I I I I. 



USER OR SUBSYSTEM/CONTINUATION LOG RECORD 

2 3 U 6 7 8 
127 



I I I I I I I I 

I 
| rec#|cksum|coda | time | DATE |log#|len| user area 

I [ .l I J I I l_l 
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LOG RECORD FORMAT (CONT) 



LOG RECORD AT CLOSELOG 

2 3 U 6 7 11 12 2k 
127 128 



■ r i iii ii i 

i i 

I rec#|cksum|code | time | date | logid|log#| creator |pcb 
I I I I I I I I I 



CRASH HARK 



2 3 U 6 
127 128 



I I I I I I 

I I 
I rec#|cksum|code | time | date | 
I I 

I I I I I I 

r n ■ 
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LOG RECORD FORMAT (CONT) 



HEADER RECORD START/RESTART 
2 3 U 6 7 11 
127 128 



T f . I ill i 

I I 
I rec#|cksum|code |time|date| logid | 

I I 

I I I I I I I 

I "1 



TRAILER RECORD 

2 3 U 6 7 11 
127 128 



I T" I I I I I 

I I 
| reef |cksum| code | time | date | logid | 

I I 

I I I I I I I 



NULL RECORD 
2 3 

127 128 



I f I ill 

I I 
| reel | cksun | code | time | date | 

I I 

I I I I I I 



CODE DEFINITION 

C0DE=1 OPEN LOG 

2 USER/SUBSYSTEM RECORD 

3 CLOSE LOG 
U HEADER 

5 TRAILER 

6 RESTART 

7 CONTINUATION OF USER OR SUBSYSTEM RECORD 
9 CRASH MARKER 

SPACE NULL RECORD 
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NOTE: 

1. The checksum algorithm uses the exclusive or function against 
a base of negative one. 

2. Null record is used for filler. 

3. The code word of the logging record can contain a subsystem 
code defined by the user in the first half of the word (0:8). 
User logging allows privileged users to pass this code in the 
index parameter of the Open Log intrinsic. 
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MEASINFOTAB 



DST = 59 (% 73) 



1 o 


LDEV # OF MEASIO | 


1 1 


MEASIO PLABEL | 


1 2 


MEASIO DST f | 


Reserved 3 
for MEASIO 
control k 






1 5 




i 6 




1 7 




| 10 


STOP' FLAG | 


1 11 


ABSOLUTE MEMORY ADDRESS | 


1 12 


INCREMENT VALUE | 


penoinuxuce 
tunning 13 


INCREMENT COUNT | 


JXU euDe vtsx 8 

I 1U 




1 15 




1 16 




1 17 




I 20 


GLOBAL STATISTICS XDS NUMBER | 


1 21 


PROCESS STATISTICS XDS BANK | 


| 22 


PROCESS STATISTICS XDS BASE | 


I 23 


PROCESS STATISTICS XDS NUMBER | 


1 2k 


CLASS 1U STATISTICS XDS BANK | 


1 25 


CLASS Ik STATISTICS XDS BASE | 



MEASLDEV 
MEASPLAB 
MEASDSTN 



MEASSTATX- 
DSNUM 

MEASPROC- 
XDSBANK 

MEASPROC- 
XDSBASE 

MEASPROC- 
XDSNUM 
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26 | 


CLASS 


lU 


STATISTICS XDS 


NUM. j 


27 1 


CLASS 


13 STATISTICS XDS 


BANK | 


30 | 


CLASS 


13 STATISTICS XDS 


BASE | 


31 


CLASS 


13 STATISTICS XDS NUM. | 


32 


CLASS 


12 


STATISTICS XDS 


BANK | 


33 


CLASS 


12 


STATISTICS XDS 


BASE | 


3U 


CLASS 


12 


STATISTICS XDS 


NUM. | 


35 


CLASS 


11 


STATISTICS XDS 


BANK | 


36 


CLASS 


11 


STATISTICS XDS 


BASE | 


37 


CLASS 


11 


STATISTICS XDS 


NUM. | 


UO 


CLASS 


10 


STATISTICS XDS 


BANK | 


Ul 


CLASS 


10 


STATISTICS XDS 


BASE | 


1*2 


| CLASS 


10 


STATISTICS XDS NUM. | 


U3 


| CLASS 09 STATISTICS XDS 


BANK 1 


kk 


| CLASS 


09 


STATISTICS XDS 


BASE | 


U5 


| CLASS 


09 


STATISTICS XDS 


NUM. | 
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MEASIHFOTAB 


(cont) 






1 




i 
reserved 
for 




measurement . 








1 50 


CLASS t 
COUNT 


D ENABLED 


CLASS 1 ENABLED | 
COUNT J 


1 51 


CLASS 


2 EN.CNT. 


CLASS 


3 EN.CNT. ! 


1 52 


CLASS 


k EN.CNT. 


CLASS 


5 EN.CNT. | 


1 53 


CLASS 


6 EN.CNT. 


CLASS 


7 EN.CNT. | 


1 5k 


CLASS 


8 EN.CNT. 


CLASS 


9 EN.CNT. | 


1 55 


CLASS 


10 EN.CNT. 


CLASS 


11 EN.CNT. | 


1 56 


CLASS 


12 EN.CNT. 


CLASS 


13 EN.CNT. | 


1 57 


CLASS 


lU EN.CNT. 


CLASS 


15 EN.CNT. | 


I 60 




1 6l 




for 62 




clock 63 




user 6k 




i 65 




1 66 




1 67 1 





1 T-hl 



MEASINFOTAB (CONT) 



I 



70 

shared 71 

eloeh 72 

interface 73 

cells 74 

75 

76 

77 

100 

101 

102 

reserved 103 
for 
event 104 
logging 

105 

106 



116 
117 



M | 



FLAG 
XDSI 



XDS2 
DCOUNT 



DLIMIT 
TCOUNT 



TLIMIT 
DLABEL 



MONITOR BUFFER INDEX 
MEAS BUFFER 



MEAS BUFFER INDEX 
MEAS ENABLED FLAGS 



MEAS ENABLED FLAGS 
MEAS BUFFER BANK 



I A 



SMONIDX 

MEASBUFO 

MEASIDX 

MEASMSKO 

MEASMSK1 

MEASBUFBANK 



M: Interrupt has missed due to last interrupt handling. 
A: Current interrupt handling active. 
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CI Stack Definition 



DB+%0 




BCOMIMAGE (Byte Ptr. To Command) 




DB+J61 


\l 
\ 
l\ 


COMMAND IMAGE 
(270 bytes) 


\l 
\ 


DB+%210 


\l 
\ 
l\ 


LINELENSTACK 
(30 words) 


\l 

\ 


DB+%246 




NEXTMSG (Not currently used) 




DB+J6247 




THIS IS SPARE 




DB+%250 




UDCO 




DB+%251 




UDC1 




DB+%252 




UDC2 




DB+&253 




UDC3 




DB+JJ254 




UDC4 




DB+5S255 




IFNESTING 




DB+%256 




IFSKIP 




DB+J5257 




ELSESEEN 




DB+%260 




CIFLAGS 




DB+J6261 




CONTINUE STATE STACK 
(2 words) 




DB+JS263 




PENDINGCOMLEN 




DB+J6264 




BLASTCOMIMAGE (Byte Ptr.) 




DB+%265 


\l 

\ 
l\ 


LAST COMMAND IMAGE 
(270 bytes) 


\l 

\ 



\ 
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Field Definitions 

BCOMIMAGE: Byte pointer to COMIMAGE (sometimes called HCOMIMAGE) 
in the CI stack. 

COMMAND IMAGE: Command character string currently being 
executed . 

LINELENSTACK: A CI command can span up to 30 input lines. This 
stack holds the length of each input line. 

NEXTMSG: Used to be used to link messages together. No longer 
being used. 

THIS IS SPARE: Not used. 

UDCO: Holds the DST number of the UDC definitions. 

UDC1: Holds the old S register value for UDC's. 

UDC2: (0:1)— FLUSHUDC, used by :SETCATAL0G 

UDC3: UDC options for current UDC. 

UDC4: (0:1)— UDC Fatal Ci Error 
(1:1)— UDC EXITBREAK 
(2:1)— UDC BREAKDETECTED 
(3:1)— UDC NOPRINT 
(4:1)— UDC IMAGEADJUST 
(10:6)— UDC NESTLEVEL 

IFNESTING: Level of nesting of :IF commands. 

IFSKIP: Whether the current commands are being skipped as the 
false part of a :IF command. 

ELSESEEN: Level of the :ELSE commands. 

CI FLAGS: (13:1) --Sequenced: line numbers at rear. 
(15:1)— Not REDOable (last command). 

CONTINUE STATE STACK: History of the : CONTINUE commands. 
= 0— no : CONTINUE 
= 1 — just seen 
= 2— in effect. 

PENDINGCOMLEN: If <> 0, command is already in stack and this 
word is the command string length. 

BLASTCOMIMAGE: Byte pointer to last command image. 

LAST COMMAND IMAGE: Before a command begins execution, the 
command string is copied here for use by the :RED0 command. 
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Association DST Layout 



Not 
Used 



Not Used | JMAT Index (8 bits) 
Not Used | JIT Index (10 bits) 



DST rel. index to user's next entry. 



Class name under which this ldev is 
associated. Left justified and 
padded with blanks. 8 bytes. 









Don't 
Care 




1 
2 
3 
4 
5 
6 



9 

10 
11 
12 
13 

M 

15 

16 

17 
18 
19 
20 



/ 

\ 



Ldev 1 
(Associated) 



- Ldev 2 

(Unassociated) 



JMAT Index or 



JIT Index or 
Next Entry Pointer or 



Classname 
or Don't Care 



7*n \ 



- Ldev n 
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There is one entry in the Association DST for every logical 
device in the system. 

Association DST number: 34 (%42) 

Association SIR number: 24 (£30) 
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CHAPTER 18 MESSAGE FILES 



Message File Mechanics 



Message File Data Structures 



This chapter contains the data structures necessary to support message 
files. The first section details the message file's version of the 
familiar file system data structure; ie, the file label, file control 
block, access control block, etc.. 

The second section show the tables used by the basic ipc mechanism 
which is a set of internal, MPE procedures designed to support the 
"boundary conditions" of ipc files. For example, signalling a no wait 
reader that its record has arrived. See the section's introduction 
for a detailed description. 



File Structure 

File label/FCB extent map 

End of file block Start of file block 







1 


• 
• 

• 


Disc addr of extent 


• 
• 

• 


• 


Disc addr of extent 1 


• 


* 
• 

• 


Disc addr of extent 2 


• 


* 


Disc addr of extent 3 


* 


z 

• 




z 

• 


• 


Disc addr of extent n-1 


• 


• 


Disc addr of extent n 


• 



The EOF and SOF are examples only, meant to show that 1) the start of 
file moves into the extent map as records are read and 2) that the 
file can wrap around and, hence, cause the SOF to be greater than the 
EOF. 

When a file becomes empty the SOF and EOF are reset to the first 
block of extent zero. 

Each extent is composed of a number of blocks. Extents all have the 
same number of blocks. Extent zero also contains space for the file 
label and user labels in the exact same format as standard files. 
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Starting with block zero, sufficient blocks are allocated to the file 
label/user labels %o satisfy their space requirements. 

Extents outside of the SOF/ECF range may not exist. They are deleted 
at close time when there are no more writers accessing the file. 
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Block Structure 

: First data record : 

. # # : Exact same format as standard 

: Second data record : variable length blocks. 

2 z 

: Last data record : 

: Record delimeter (-1) : „..„...„„.,„...„...,„.„... 

: : 

: Empty space (next record : 
: would not fit) : 

• I 

: Header delimiter (%77) : 
: Last header record : 

• 

2 Z 

: Second header record : 

j : 

: First header record : 

Separating the data portion of the records from their header enables 
the standard file system access procedures to read the records with no 
knowledge that they are msg file records. 
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Record Format 



: Number of bytes in record : 

«... • 

: First data word of record : 

• • 

z z 

• • 

: Last data word of record : 



Length word's value does not include itself. 



Header Format 



: C:LC: Header Type: 
: Writer's ID : -1 



C (0:1) - Set on if this was the last record written before 
the system crashed. This bit is set on by the 
first open on the file after the crash. 

LC (1:1)- Valid only for close headers. Set to one if this is 
the last writer to close the file. 

Type(8:8)- data 

1 open 

2 close 
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Message Access Control Block 

Notes : 

1. Words/fields that do not pertain to message files are left 
blank. 

2. This diagram shows the "combined" ACB as it appears to 
the message access procedures (the procedures in IPC). 
Thus it is a combination of the LACB and the PACB. 



: : Size of the ACB including buffers (words) : 

1 : : File number : 1 * 



2 : File name 



: 2 * 

» 



6 : Foptions 

7 : Aoptions 



: 6 » 

! 7 * 



8 : Record size (bytes) 

9 : Block size (words) 



10 * 

11 » 



z z 

11 : Carriage control code (writers) : 13 * 

z z • 

lU : Error code : 16 * 

15 : Transmission log (units same as last read/write) : 17 * 

16 : Total number of unread records (includes opens : 20 

17 : and closes) : 21 

18 : Block number of the file's tail (relative to the : 22 

19 : start of file block) : 23 

20 : Logical record transfer count : 2k 

21 : : 25 
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22 : Physical block transfer count . : 26 

23 : : 27 
2k : Address of the head record's header : 30 

25 : Address of the next write header : 31 

26 : FCB control block vector : 32 
z z 

28 : Number readers : Number readers & writers : 3k 

29 z z 

30 : : Records per block : 36 

31 :Wrt buf indx: : # buf - 1 : 37 

32 : Address of the head record's data : kO 

33 : Size of the buffer (words) : Ul 
z z 

38 : : Logical device number : U6 

39 :0:# rd buf : # wt buf :er :qw :m :c :d :s :f : U7 

kO : Number of max sized free records : 50 

1*1 : : 51 

U2 : Number of free words in the current free record : 52 

1*3 : Address of the next write record : 53 

kk : Number of nondata records in the file : 5k 

^ ................................... ........ . ••••; ^ 

U6 : # of read requests that have a claim on file : 56 

1*7 : Last read error : Last write error : 57 

U8 : DST number of the physical ACB : 60 

1»9 : Address of the physical ACB : 6l 
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50 : DST number of the logical ACB : 62 

51 : Address of the logical ACB : 63 

52 : DST rel address of the stack access control blk : 6k 

53 : DST rel address of the DB area : 65 
5U : PACB vector table entry address : 66 

55 : PACB control block vector table address : 67 

56 : Target area's DST number : 70 

57 : Reserved for calling parameters : 71 
^ ................ ^ 

^ ........... ^ 

60 : Reserved for the stack marker from file system : Jk 

61 : intrinsics * 75 



2 



Z 

6U : lumber of seconds to wait on boundary condition : 100* 

65 : 0:Ex:Nd:Vr:Bt:Cls :C : Carriage control : 101* 

66 : Reply Port (basic IPC port) : 102* 
67- : Writer ID » K>3 # 

68 : Control block index for nowait writer record buf : 10k* 

69 : DST relative addr of nowait writer record buffer : 105* 

70 : lo wait I/O resultant error code : 106* 

71 : lo wait I/O resultant transmission log : 107* 

72 : Write wait queue (basic IPC port) : 110 

73 : Read wait queue (basic IPC port) : 111 
7U : Head record's length (bytes) : 112 
75 : Head record's record type (same values as header): 113 
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76 : 


: Head record's writer ID 


: 


77 : 


: Head record's header word value 


: 


78 : 


: Max size record plus its overhead (words) 


* 



11U 
115 

« I., IP 

79 : ACB wait queue message - contains same info as : 117 

80 : the wait queue message in the Message Queue : 120 

81 : Entry : 121 

82 : : 122 
Bk : Waiter's reply port, if using ACB compltn area : 12b 

85 : ACB completion message area - see Message Queue : 125 

86 : Entry for completion message format : 126 

87 : Waiting process's PCB address (rel to PCB base) : 127 

88 : DST rel address of buffer one : 130 

89 : DST rel address of buffer two : 131 

90 : Etc. : 132 

* Value is private to a particular accessor. 
Word Field Description 



65 Accessor' s local flags. 

(0:1) 1 - have not yet issued an FREAD/FWRITE against 

the file. 
(1:1) ex 1 - extended wait mode. 
(2:1) nd 1 - do not destroy the next record read. 
(3:1) vr 1 - writer has not yet written his first record 

(ie., he is a virgin). 
(U:l) bt - transmission log should be expressed in words. 

bytes. 
(5:1) els Mot currently used (reserved for group IPC 

standard). 
(6:1) C No wait completion message is in LACB area. 
(8:8) car ctl carriage control character to be used for 
the writer's record (a value of one indi- 
cates no carriage control character) . 
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Word Field Description 

39 File's global flags. 



(9:1) er 1 - extended read 

(10:1) qw 1 - one or more writers has been queued on the 

wait queue. 

(11:1) m 1 - wait msg is located in the ACB 

(12:1) c 1 - completion msg is located in the ACB 

(13:1) d 1 - the current write buffer has dirty bit set 

(lU:l) s 1 - the start of file is block zero 

(15:1) f - the ACB buffers have not been filled 
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MMSTAT Definitions 

Octal Event Type Parameter 1 
Value 



Parameter 2 



72/0 


Read init 


§ free rec 




72/1 


Read compl 


(0:8) error, 


(8:8) ID 


72/2 


Write init 


(0:8) # rec, 


(8:8) ID 


72/3 


Write compl (0:8) error, 


(8:8) ID 


72/U 


Control 


(0:8) error, 


(8:8) ID 


72/5 


EOF 


(0:8) error, 


(8:8) ID 


72/6 


Open 


(0:8) error, 


(8:8) ID 


72/7 


Close 


(8:8) ffree, 


(8:8) ID 


72/10 


Initiation 







73/0 


Put record 


(0:8) error, 


(8:8) ID 


73/1 


Delete rec 


(0:8) error, 


(8:8) ID 


73/2 


Delete blk 


Start of file block f 



Number of records 

Number of free records 

Number of free records 

(0:U) func, (U:12) parm 

Number of records 

Number of records 

Number of records 

(0:8) fix, (8:8) update 

(0:3) rec type, 

(3:13) number of records 

(0:3) rec type 

(3:13) number of records 

End of file block # 



Notes: 



1. The aa/bb notation in the "octal value" column denotes 
type/subtype. Type is the actual M1STAT event number. 
Subtype is (0:U) of parameter 0. 

2. Several items can possibly exceed their fields, in that 
case the bits beyond the field are lost. These items are 
number of records, number of free records, start of file, 
and end of file. 
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3. Parameter word zero has a common format for all the MMSTAT 
events . 



Field 
(0:»0 
(U:2) 



(6:1) 
(7:1) 
(11:1) 
(12:U) 



Description 
Event's subtype. 



File's state 

- empty 

1 - partially full 

2 - only a fraction of a free record is left 

3 - completely full 

Honzero indicates that there is one or more 
waiting readers. 

Nonzero indicates that there is one or more 
waiting writers. 

Honzero indicates that the write has a carriage 
control character. 

Flags local to the accessor. 

(12:1) - the accessor has done no FREADs/FWRITEs 

(13:1) - extended wait 

(lU:l) - nondestructive read 

(15:1) - writer has not written any records 
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File System Basic IPC Definitions 



The objective of this set of uncallable procedures is to provide a 
simple ipc mechanism to support the ipc file access procedures. It 
enables one process to send short, control messages to another process. 

General behavior 

FCPORTOPEN procedure 

The heart of this mechanism is the port. A process desiring to 
receive messages would first open (create) a port. This process is 
termed the "port manager." When the port is created, a port number is 
returned to the opener. Since the port number value cannot be known 
in advance, potential senders need some method of obtaining the port 
number from the port manager. 

Both the ports and the messages are contained in a single disc 
resident data segment. There can be a total of over thiry-five 
hundred open ports and outstanding messages Thus neither ports nor 
message blocks are scarce resources. 

FCPORTSEND procedure 

This procedure sends a to 5 word message to a port. Optionally a 
timeout value may be specified which will limit the duration the 
message will remain attached to the port. Expiration of the timeout 
causes the message to be deleted from the target port's queue and 
placed on the sender's reply port (specified by the sender in the 
FCPORTSEHD procedure call). 

FCPORTRECEIVE 

Reads and deletes the head message from a port. The sender's return 
port number is also given to the receiver, enabling him to send a 
reply message. 

FCPORTCLOSE 

Demolishes the port. 



IPC file's use of this mechanism 

All open message files have two ports open for the file (read wait 
queue and write wait queue), plus one port per accessor (reply port), 
Their use is described in the following. 
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Reader and writer wait queues 

When an empty message file is accessed by more than one reader 
(share), then there must be a way of having the readers' FREADs 
satisfied in the same order that they were issued. That is, there 
must be queue of waiting readers. The ipc access procedures 
accomplish this by dedicating a basic ipc port as a "read wait 
queue." Whenever a reader's request is stalled because the file 
is empty, a message is sent to the read wait queue. Subsequent 
FREADs by other processes will queue up behind the first reader in 
a FIFO manner. An FWRITE will take the first entry from the wait 
queue and send a "read may be done" message to the reader's reply 
port. 

In a like manner multiple writers will queue on the write wait 
queue when the file is full. 

Completion notification for nowait I/O 

The IOWAIT intrinsic waits for a message to be sent to the reply 
port (s) of the specified user files. 

Timeouts 

When an accessor encounters a boundary condition (ex, a reader 
accesses an empty file), it may specify that the condition must be 
satisfied in x seconds (FCONTROL k) . To this end the ipc access 
procedures merely issue the FCPORTSEHD to the wait queue with the 
user's timeout value specified. The timeout will tear the message 
from the wait queue and place it on the accessor 's reply port. 
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Port Data Structures 
Port data segment 



System DB extension :Port DST #: 
+ %100 



Port data segment 



Global area 



Remainder is 
composed of 
"block size" 
chunks. 



The chunks are a combination of free entries, ports, message queue 
entries, and timer list entries. 



Port with two outstanding messages 



Port 



MQE 1 



•>: 



: HQE 2 
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Port number 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 16 
• • • • • • • • • .;..:..:.. !..!••!•••••• 

:Port index : Port data segment relative addr/8 

Port index Index into the port DST number array 



Port DST Number Array 
Located in System DB Extension Area. 

6k : Port data segment number s 6U 

65 : Reserved for a second port segment : 65 
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Port Data Segment Global Area 



: Data segment number of this port data segment : 

1 : Block size in words : l 

2 : Total number of blocks : 2 

3 : Maximum number of blocks : 3 
U : Current number of free blocks : It 

5 : Number of open ports : 5 

6 : Head of free list : 6 

7 : Tail of free list : 7 

10 : Head of impeded process list : 8 

11 : Tail of impeded process list : 9 

12 : Head of timeout thread (TQE address) : 10 

13 : TRLX of timeout J H 
Ik : Value returned by TIMER intrinsic when : 12 

15 : Timeout was initiated. : 13 

16 : Head of port address list. : lh 

17 : Not used. 



: 15 
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Port 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

• • ♦ ♦ • • • ♦ • • *•»!••?••!•«•••• 

: Head MQE address : ° 

1 : Tail MQE address : 1 

2 :E : W : Port list thread. : 2 

3 : Reserved : Port manager pin : 3 

k ;" R ;;;i4; d • * 

5 : Number of HQEs in the port's queue : 5 

6 : Number of sends to this port : 6 

7 : Reserved : 7 
:0 :1 :2 :3 :i :5 :6 :7 :8 :9 tlOrllt^rlS:! 1 *:!?: 

E Enable wake up bit 

- Do not awaken the process 

1 - Awaken the process 

W type Action to be taken on an enabled port when a message is 
received. 

- Awaken the process on a message wait bit. 
1/3 Reserved for future use. 
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Message Queue Entry (MQE) 

1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 16 
•••:••:..:.,:•<: • • • • • • • • • • 

: Next MQE entry; if last, (port addr) LOR 7 : 

1 : Return port : i 

2 :Time List Entry (TLE),0=no timeout, -l=timed out: 2 

3 : Parameter zero : 3 
h : Parameter one : 1» 

5 : Parameter two : 5 

6 : Parameter three : $ 

7 : Parameter four : 7 
JO :1 :2 :3 :U :5 :6 :7 :8 :9 :10:ll:12:13:lU:15: 

Timer entry definitions - - no timeout 

1 - timeout expired 

2 - TLB address for a pending timeout 

File System Message Files 



Wait Message 

parm# 

- WRITER ID 

1 . - LOCAL FLAGS (differ with each accessor) 

(0:1) - accessor just opened file 

(1:1) - will wait on boundary condition if no symbiotic process 

(3:1) - writer has not written a record 

(U:l) - transmission log in bytes 

(8:1) - carriage control code 

2 - DST# of data buffer 

3 - Address of data buffer (DST relative) 
U - Length of data buffer in bytes 

Completion Message 

- Resultant error code 

1 - Resultant transmission log in bytes 
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Timer List Entry (TLE) 
1 2 3 U 5 6 7 8 9 10 11 12 13 lU 15 

: Hext TLE (sorted in incr time val) , if last: 

1 : Preceding TLE entry (0 if first entry) : 1 

2 : Number of milliseconds the timeout value : 2 

3 : of this TLE is beyond the previous TLE. : 3 
k : Address of the affected MQE : ** 

5 : Address of the MQE's port : 5 

6 : Set to %000125 if active, %000252 when done : 5 

7 : Value of TIMER when timeout expires (sees) : 7 
Yo":l:2:3'.k:5:6 :7 :8 :9 ilO:!!:^:^:! 1 *:!?: 
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MMSTAT Definitions 



Octal 


Event Type 


Parameter 


Parameter 1 


Parameter 2 


Value 










62 


Open 


Port number 


Port DST num 


Flags paramet 


63 


Receive 
completion 


Port number 


HQE address 
15:1 Waitspc 


Return port 


6k 


Send 


Port number 


HQE address 
15:1 Q type 


Return port 


65 


Change 


Port number 


= enable 


Head MQE 




status 




1 = disable 


address 


66 


Abort 


Port number 


Parameter 
zero 


Return port 


61 


Close 


Port number 


Port DST 


# open 
ports left 


70 


Expand 


Port DST num 


# expand blks 


Total # 
blocks 


71 


Timeout 


Port num 


HQE address 


Return port 




expired 
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CHAPTER 19 MPE Memory Resident Message Facility 



I. Overview of Facility 

The memory resident message facility of MPE IV addresses the need 
for an efficient, simple, and uniform method for system code to 
send short status-type messages to processes. 

Each process is created with a message harbor which supports a 
set of message ports which are private to that process. There 
is a maximum of four ports per harbor in the initial 
implementation. This limit can be easily extended when new ports 
are required. 

Any system code, even code running on the ICS, can send a message 
to any port of any process. The destination process' PIN must be 
known, and a priori conventions on portnumber and message 
formats must be established. The caller of SENDMSG may optionally 
specify that the destination process be awakened from a message 
wait. 

The caller of SENDMSG specifies whether the message is to be 
buffered in the primary message table or the secondary message 
table. When the secondary table is specified, if the pool of 
secondary message entries is exhausted, the calling process is 
queued for a message table entry and blocked until one becomes 
available. Use of the primary message table is reserved for code 
running on the ICS or during critical sections (Pdisabled or 
Disabled intervals) in which it is not possible to release 
control of the processor to queue for a free message table entry. 
If the primary table is specified and no free entries are 
available, the SENDMSG crashes the system. 

Messages can be of any length up to the configured maximum. 
Message length is specified in the call to SENDMSG and 
RECEIVEMSG. In the initial implementation, messages are limited 
to k words in length. This maximum can be easily increased if the 
need arises. 

By calling PORTSTATUS, a process may at any time determine 
whether a specified port is non-empty or obtain the portnumber 
of his most urgent non-empty port (lowest numerical port number 
=most urgent port ) . 

By calling RECEIVEMSG, a process may receive the message at the 
head of his specified message port. This receive is optionally 
non-destructive . 

A process can wait on a message wait, or on a combination of 
message wait and other wait types . 
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II. Message Intrinsics 



Procedure SENDMSG(Destpin, Destport, Msglength, Flags) ; 
Value Destpin,Destport ,Msglength, Flags ; 
Integer Destpin , Destport ,llsglength; 
Option Privileged, Uncallable; 
Logical Flags; 

Destpin, Destport, and Msglength had better be within 
range and reasonable (process and port exist), since 
SENDMSG checks and will crash if the parameters are bad. 

The caller of SEHDMSG stacks the message contents before 
calling the procedure. SENDMSG expects the first msg 
word to be at Q-7-Msglength, and the last msg word at 
Q-8. The message contents at Q-8 to Q-7-Msglength are 
deleted from top of stack by the exit from SENDMSG to 
the caller. 

Flags. (1:1) =1 ==> Wake-up destination process from a 

message wait 
. (0:1)=1 «> place message in secondary message 

table 
Return CC=CCG if process was already awake else CC=CCE. 



Logical Procedure PORTSTATUS (Portnumber); 

Value Portnumber; 

Integer Portnumber; 

Option Privileged, Uncallable; 

When supplied a valid port number, PORTSTATUS returns a 
true value if the port is non-empty and a false value if 
the port is empty. 

When passed a -1 as portnumber parameter, PORTSTATUS 
returns the portnumber of the process' most urgent 
non-empty port (the smaller the number, the more urgent 
the port) . 

If all ports are empty, PORTSTATUS returns CC=CCE. If 
at least one port is non-empty, PORTSTATUS returns 
CC=CCG. 
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C. Procedure RECEIVEMSG (Portnum,Msglength, Flags ) ; 
Value Portnum , Msglength , F lags ; 
Integer Portnum, Msglength; 
Option Privileged, Uhcallable; 
Logical Flags; 

Portnum and Msglength had better be within range or else 
its Suddendeath time. 

The caller of RECEIVEMSG does an ADD S Msglength to make 
space for the message contents. RECEIVEMSG stores the 
message contents into Q-8,Q-9, . . . ,Q- 7 -Msglength. 
Q-7-Msglength contains the first word of the message. 

Flags. (0:1) =1 ==> do not release message from head of 

port ' s message queue (non-destructive 
read) 

Return CC=CCG if port was empty, else CC:=CCE. 
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III. Supporting Data Structures 
A. Message Harbor Table [DST #57 (%71 ) 3 



The message facility is presently used only by the Dispat- 
cher and should not be used by any process. The Message 
Harbor Table is created during system generation. It is a 
resident structure, though needn't reside in bank 0. Its 
base is located through the DST entry which describes it. 



» • 

* LINK TO FIRST MSG PORT * MESSAGE HARBOR 
* • 

* LINK TO FIRST MSG PORT 1 * TABLE ENTRY 
* • 

* LINK TO FIRST MSG PORT 2 * FORMAT 
» « 

* LINK TO FIRST MSG PORT 3 * 
* • 

* NON-EMPTY PORT MASK • 



* 



* 



FIRST MSG QUEUE LINK .(0:1) =1 ==> NEXT MESSAGE IN SECONDARY 

MESSAGE TABLE 
.(1:15) ■ INDEX OF NEXT ENTRY IN 
APPROPRIATE TABLE 
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MESSAGE TABLES 



Prim Msg Tab DST = #58 (%72) 
Sec Msg Tab DST = #60 {%7k) 

There are two flavors of tables which are used to buffer 
sent messages, the primary and secondary message tables. 
The tables are identical in format, but independently 
configurable with respect to size. Both tables are residen 
structures, though they needn't be located in bank 0. 
The bases of the message tables are located by looking up 
their addresses in the DST entry describing them. 



* # OF CONFIGURED ENTRIES * 

« « 

* # ENTRY SIZE (5) * MESSAGE TABLE 

« » 

* # ENTRIES AVAILABLE * ENTRY ZERO 

• # 

* INDEX OF FIRST FREE ENTRY * FORMAT 
• • 

* PIN OF FIRST IMPEDED PROCESS * 

* » 



* NEXT MSG IN QUEUE LINK * MESSAGE TABLE 

« » 

* MSG WORD 1 * ASSIGNED ENTRY 

# # 

* MSG WORD 2 * FORMAT 
« • 

* MSG WORD 3 * 

« # 

* MSG WORD U * 

* * 



* %100000 * 

* INDEX NEXT FREE ENTRY * 

* # FREE ENTRY 

* Don't Care * 

* * FORMAT 

* Don't Care * 

# # 

* Don't Care * 
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NEXT MSG IN QUEUE LINK .(0:1) =1 ==> NEXT MESSAGE IN SECONDARY 

MESSAGE TABLE 
.(1:15) ■ INDEX OF NEXT ENTRY IN 
APPROPRIATE TABLE 
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Message Port Assignments 



Message Port 

Message Port 1 
Message Port 2 
Message Port 3 



Junk Port (to be used when no message 

interference can occur.) 
Reserved (for message facility) 
Reserved (for message facility) 
Image Port 
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HP3000 
MMSTATS EVENT CATALOG 



MMSTAT CATALOG INDEX 



EVENT 


DESCRIPTION 


PAGE 


GROUP 


OF GROUP 


NO. 





MEMORY MANAGER 


20-1 


1 


MEMORY MANAGER 


20-9 


2 


MEMORY MANAGER 


20-10 


U 


SCHEDULING 


20-13 


6 


FILESYS 


20-16 


7 


FILESYS 


20-25 


8 


FILESYS 


20-30 


9 


DISC I/O TRANSFER 


20-31 


10 


DISC ERRORS 


20-32 


11 


SIO 


20-33 


12 


DISC SPACE 


20-3U 


1U 


cs/3000 


20-36 


15 


CS/3000 


20- UO 


16 


CS/3000 


20-U3 


19 


DISC CONTROLLER INTRPT 


20-UU 


20 


PRIVATE VOLUMES 


20-U7 


21 


PROCESS CREATION AND TERMINATION 


20-U8 


22 


MONITOR CONFIG INFORMATION 


20-U9 


23 


TERMINAL I/O 


20-53 





MMSTATS CATALOG INDEX 






EVENT NAME 


EVENT NO. 




EVENT NAME 


EVENT NO. 




DEC. 


% 






DEC. 


* 


ALCSTBLK 


20 


021* (-) 


* 


FREAD 


62 


076 (-) 


ALLOCMEM 


12 


Oil* 


* 


FREADDIR 


61* 


100 (-) 


BINREAD 


233 


351 (-) 


* 


FREADLABEL 


76 


111* (-) 


BREAK 


237 


355 (-) 


H 


FREADSEEK 


68 


101* (-) 


CABORTIO 


11*2 


216 


* 


FRENAME 


80 


120 (-) 


CCLOSE 


11*6 


222 


« 


FSETMODE 


72 


110 (-) 


CCLOSETRACEFILE 


151* 


232 


* 


FSPACE 


69 


105 (-) 


CCONTROL 


152 


230 


* 


FUNLOCK 


79 


117 (-) 


CGARBAGE 


7 


007 


* 


FUPDATE 


66 


102 (-) 


CONFIG- INFO 


221 


335 (-) 


* 


FWRITE 


63 


077 (-) 


CONFIG- INFO 


222 


336 (-) 


* 


FWRITEDIR 


65 


101 (-) 


CONFIG-INFO 


223 


337 (-) 


* 


FWRITELABEL 


77 


115 (") 


COPEN 


11*0 


21 1* 


* 


GIPINTERRUPT 


192 


300 


COPENTRACEFILE 


153 


231 


* 


IOBUFTRAP 


125 


175 


CPOLLIST 


155 


233 


* 


I/O COMPLETION 


111 


157 (-) 


CREAD 


ll*7 


223 


* 


IOWAIT 


67 


103 (-) 


CREAD1 


11*7 


2U0 


* 


MAKEOC 


1 


001 


CSDRIVER 


150 


226 


* 


MONINIT 


228 


31*1* (-) 


CSIOWAIT 


ii»it 


220 


* 


MONOFF 


229 


3U5 (-) 


CWRITE 


11*9 


225 


* 


PROCESS COMPLETE 


211 


323 (-) 


DC1DC2ACK 


231 


3U7 (-) 


* 


QONSEG 





000 


DEALLOCH 


13 


015 


* 


QUIESCE 


1*0 


050 


DEALCSTBLK 


21 


025 (-) 


* 


RELRESOURCES 


23 


027 (-) 


DISKBUGCATCHER 


200 


310 


« 


SEGIOINIT 


5 


005 


DISKBUGCATCHER 


201 


311 


* 


SIODM 


195 


303 


DISKERROR 


100 


11*1* (-) 


* 


SIODONE 


6 


006 


DISKERROR 


101 


H*5 (-) 


* 


SPECCHAR 


236 


351* (-) 


DISKINTRPT 


191 


277 


« 


SPECIALRQ 


2 


002 


DISKSPACE 


120 


170 (-) 


* 


SPECREAD 


238 


356 (-) 


DISKSPACE 


121 


171 (-) 


« 


START I/O 


110 


156 (-) 


DISK TRAFFIC 


98 


H*2 (-) 


« 


SWAPIN 


8 


010 


FCHECK 


7U 


112 (-) 


• 


SYSPINS 


22U 


31*0 (-) 


FCLOSE 


81 


121 (-) 


« 


SYSPINS 


225 


31*1 (-) 


FCONTROL 


71 


107 (-) 


* 


SYSPINS 


226 


31*2 (-) 


FETCHSEG 


l* 


00U 


» 


SYSPINS 


227 


31*3 (-) 


FGETINFO 


75 


113 (-) 


* 


TERMLOGOFF 


235 


353 (-) 


FLOCK 


78 


116 (-) 


* 


TERMLOGON 


23I* 


352 (-) 


FOPEN/(DA) 


60 


07U (-) 


* 


TERMREAD 


230 


3U6 (-) 


FOPEN/(DA) 


61 


075 (-) 


* 


TERMWRITE 


232 


350 (-) 


FPOINT 


70 


106 (-) 


* 









♦♦a************************************************************* 

* * 

« * 

* 



« * 

* MEMORY MANAGEMENT EVENTS * 



» MMSTAT EVENT GROUP 

» 

* MEMORY MANAGEMENT EVEJ 

ihkhhk######»####»»»##»«**»»***#****** ************************* 

EVENT 

EVENT NAME: OONSEG 

DESCRIPTION: ABSENCE TRAP ON CODE/DATA SEGMENT 

CALLING MODULE: KERNELC 

CALLING PROCEDURE (S): QUEUEONSEGMENT 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

.(2:lU) = DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT, 

.(2:lU) = SL ENTRY NUMBER 
= 2,3 => SEG IS PART OF A PROGRAM, 
.(1:7) = PROGRAM INDEX 

INTO CSTBLK 
.(8:8) - LOGICAL SEGMENT 
NUMBER (0-255) 
P2 = PCBOl(CPCB) - SLL POINTER 
P3 = STATUS (IN STACK MARKER) OF CALLING (TRAPPING) SEGMENT 
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EVENT 1 



EVENT NAME: MAKEOC 

DESCRIPTION: MAKE SEGMENT AN OVERLAY CANDIDATE - RELEASE SEGMENT 
TO THE POOL OF AVAILABLE SPACE 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: MAKEOC 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT 

. (2:lU) = DST ENTRY NUMBER 

=1 => SEG IS AN SL SEGMENT 

.(2:110 = SL ENTRY NUMBER 

= 2,3 ■> SEG IS PART OF A PROGRAM, 

.(1:7) ■ PROGRAM INDEX 

.(8:8) = LOGICAL SEGMENT NUMBER 

(0-255) 
P2 = (UNUSED) 

P3 ■ (UNUSED) 
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EVENT 2 



EVENT NAME: SPECIALRO 

DESCRIPTION: REQUEST OF SEGMENT EXPANSION/CONTRACTION, UNLOCK, 
UNFREEZE, IOUNFREEZE, LOCK, IOFREEZE, FREEZE 

CALLING MODULE: KERNELC, KERNELD, ININ 

CALLING PROCEDURES: UNLOCKSEG' , IOFREEZE', FETCHSEGMENT- (KERNELC) 

DLSIZE, ZSIZE, GETPXSEG, ALTDSEGSIZE, 
ALTPXFILESIZE -(KERNELD) 

STACKOVERFLOW - ( ININ) 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

.(2:lU) = DST ENTRY NUMBER 
=1 => SEG IS AN SL SEGMENT, 

.(2:ll4) = SL ENTRY NUMBER 
=2,3 => SEG IS PART OF A PROGRAM, 
.(1:7) ■ PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 = .(0:1) =1 => REQUEST IS THROUGH FETCHSEGMENT (TYPES 

0,1,2) 
. (12:U) TYPE OF REQUEST 
= 0=> IOFREEZE 
= l=> FREEZE 
= 2=> LOCK 

* 3=> IOUNFREEZE 
= U=> UNFREEZE 

= 5=> UNLOCK 
= 6=> DLSIZE EXPANSION 
= 7=> DLSIZE CONTRACTION 
= 8=> PXFIXED EXPANSION 

* 9=> PXFILE EXPANSION 

= 10= > PXFILE CONTRACTION 
= 11=> XDS EXPANSION 
= 12=> XDS CONTRACTION 
= 13= > ZSIZE EXPANSION 
= 1U=> ZSIZE CONTRACTION 
= 15= > STACKOVERFLOW 
P3 = FOR TYPES (P2.(12:U)) 

= 0,2,3,5 => P3-(8:8) = LOCK OR IOFREEZE COUNT 

= 1,1* => P3.(0:8) = FREEZE COUNT 

= 6-15 => REQUESTED SIZE OF AREA IN WORDS 
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EVENT U 



EVENT NAME: FETCHSEG 

DESCRIPTION: SEGMENT REQUEST (FOR I/O SYSTEM OR PROCESS) 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: FETCHSEGMENT 

PARAMETER DESCRIPTION 

PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

. (2:lU) = DST ENTRY NUMBER 

=1 => SEG IS AN SL SEGMENT, 

.(2:llt) = SL ENTRY NUMBER 

■ 2,3=> SEG IS PART OF A PROGRAM, 

.(1:7) = PROGRAM INDEX 

INTO CSTBLK 

.(8:8) = LOGICAL SEGMENT 

NUMBER (0-255) 
P2 = REQUESTORID 

.(0:1) =1 => I/O SYSTEM REQUEST 
.(8:8) = LDEV # 
(0:1) =0 => PROCESS REQUEST 

.(8:8) = PIN # OF REQUESTING PROCESS 
.(1:1) = 1 => IOFREEZE REQUEST 
.(2:1) =1 => BLOCKED LOCK REQUEST 
. (3:1) =1 => LOCK REQUEST 
. (U:l) =1 => FREEZE REQUEST 
P3= .(13:3)= => SEGMENT ALREADY PRESENT 

=1 => SEGMENT IS RECOVERABLE OVERLAY CANDIDATE 
=2 => SEGMENT ALREADY ON ITS WAY IN FOR SOMEONE 
=3 => SEGMENT NOT PRESENT -- MUST FETCH 
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EVENT 5 



EVENT NAME: SEGIOINIT 

DESCRIPTION: MEMORY MANAGEMENT READ/WRITE OF SEGMENT FROM/TO 
DISC QUEUED 

CALLING MODULE: KERNELC 

CALLING PROCEDURES: PROCESSINITMSG, STARTSEGWRITE 

PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER.(0:2) = SEG TYPE FIELD 

=0 => SEG IS A DATA SEGMENT, 

.(2:1*0 = DST ENTRY NUMBER 
= 1 -> SEG IS AN SL SEGMENT, 

.(2:lU) = SL ENTRY NUMBER 
= 2,3 => SEG IS PART OF A PROGRAM, 
.(1:7) ■ PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 = DISCREQUEST INDEX - INDEX INTO THE DISC REQUEST TABLE 

(SYSDB RELATIVE) 
P3 = . (0:1) = 1 -> WRITE START 
= => READ START 
.(2:15) = LDEV # 
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EVENT 6 



EVENT NAME: SIODONE 

DESCRIPTION: MEMORY MANAGEMENT SEGMENT READ/WRITE FROM/TO DISC 
COMPLETE 

CALLING MODULE: KERNELC 

CALLING PROCEDURES: SEGREADCOMPLETOR , SEGWRITECOMPLETOR 



PARAMETER DESCRIPTION 



PI = SEGIDENTIFIER. (0:2) = SEG TYPE FIELD 



= 



= 1 => 



SEG IS A DATA SEGMENT, 
.(2:11*) = DST ENTRY NUMBER 
SEG IS AN SL SEGMENT, 
. (2:lU) = SL ENTRY NUMBER 
= 2,3=> SEG IS PART OF A PROGRAM, 
.(1:7) ■ PROGRAM INDEX 

INTO CSTBLK 
.(8:8) = LOGICAL SEGMENT 
NUMBER (0-255) 
P2 = DISCREQUEST INDEX - INDEX INTO THE DISC REQUEST TABLE 

(SYSDB RELATIVE) 
=> WRITE COMPLETE 
=> READ COMPLETE 



P3 



= .(0.1) = 1 
= 
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EVENT 7 (%7) 

EVENT NAME: CGARBAGE 

EVENT DESCRIPTION: GARBAGE COLLECTION HAS JUST TAKEN PLACE 

CALLING NODULE: KERNELC 

CALLING PROCEDURE: COLLECTGARBAGE 

PARAMETER DESCRIPTION 

PI = BANK OF SOURCE JUST MOVED FROM 
P2 = ADDR OF SOURCE JUST MOVED FROM 
P3 - MOVEPAGECNT, NUMBER OF PAGES JUST MOVED FROM 
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EVENT 8 (%10) 



EVENT NAME: SWAPIN 
DESCRIPTION: SWAP IN A PROCESS 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: SWAPIN 

PARAMETER DESCRIPTION 



PI ■ PIN OF PROCESS BEING SWAPPED IN 
P2 = .(0:1) ■ => BEING SWAP 
= 1 => END SWAP 
.(1:1) = => NORMAL (PARTIAL SWAP OK) 

= 1 => SWAP REQUIRED 
.(12:U)= => PROCESS SWAPIN COMPLETE 

2 »> NO ROOM, HARD REQ MAT SUCCEED 

3 -> NO ROOM, HARD REQ FAILED 

U *> SWAPIN STOPPED - MORE URGENT ACTIVITY 
8 => NO LOCK SPACE 
P3 ■ HARDREQUEST = TRUE => HARD REQUEST ON SWAPIN 

FALSE=> NORMAL 
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« • 

» » 

* MMSTAT EVENT GROUP 1 * 

* MEMORY MANAGER * 

* « 



EVENT 12 (%1U) 



EVENT NAME: ALLOCMEM 

DESCRIPTION: FOUND A HOLE FOR A SEGMENT REPLACEMENT REQUEST 

CALLING MODULE: KERNELC 

CALLING PROCEDURE: RESERVEREGION 

PARAMETER DESCRIPTION 

PI = REQUESTED SIZE IN PAGES 
P2 = BANK OF SELECTED REGION 
P3 = ADDRESS OF SELECTED REGION 



EVENT 13 (%15) 



EVENT NAME: DEALLOCM 

DESCRIPTION: RELEASE REGION OF MEMORY TO AVAILABLE STATUS 

CALLING MODULE: KERNELC 

CALLING PROCEDURE: RELEASEREGION 

PARAMETER DESCRIPTION 



PI = SIZE RELEASED IN PAGES 

P2 = BANK OF RELEASED REGION BASE 

P3 = ADDRESS OF RELEASED REGION BASE 
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MMSTAT EVENT GROUP 2 « 

* • 

TTwtflfffffwff w§tw§fttt>tt#Iff§ttttttttt#§t^#§§t###l-ii>t<tMMM|MM|M MM M M M M M M M 

EVENT -20 (-%2k) 

EVENT NAME: ALCSTBLK 

DESCRIPTION: REQUEST TO RESERVE A BLOCK OF ENTRIES IN THE CSTX 

CALLING MODULE: KERNELD 
CALLING PROCEDURE: ALCSTBLOCK 

PARAMETER DESCRIPTION 



P1=EIX CST BLOCK INDEX ASSIGNED 

P2=CSTX DST RELATIVE INDEX OF WORD 

OF THE FIRST RESERVED CSTX ENTRY 
P3*N NUMBER OF CSTX ENTRIES RESERVED 



EVENT -21 (%25) 

EVENT NAME: DEALCSTBLK 

DESCRIPTION: INDICATES THAT A CST EXTENSION BLOCK HAS BEEN 
DEALLOCATED 

CALLING MODULE: KERNELD 
CALLING PROCEDURE: DEALCSTBLOCK 

PARAMETERS PARAMETER DESCRIPTION 

P1=EIX CST BLOCK INDEX ASSIGNED 

TO THE BLOCK OF CST ENTRIES 

P2=CSTX DST RELATIVE INDEX OF WORD 
OF THE FIRST CST ENTRY TO BE 
RELEASED 

P3=MCNT =(#ALLOCATED CSTX ENTRIES- 

lENTRIES BEING RELEASED)*** 
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EVENT -23 (-%27) 

EVENT NAME:RELRESOURCES 

DESCRIPTION: RESOURCES (VDS,MAIN MEMORY, ST ENTRY) RESERVED FOR THE 
FOR THE SEGMENT HAVE BEEN RELEASED 

CALLING MODULE: EERNELD 

CALLING PROCEDURE: RELDATASEG 

PARAMETERS PARAMETER DESCRIPTION 

P1=NEW DB DST NUMBER 
P2=DELTA P AT EXCHANGEDB CALL 

P3=STATUS AT EXCHANGEDB CALL 
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* * 

* * 

* MMMSTAT EVENT GROUP 3 * 

* (HOT CURRENTLY ASSIGNED) * 

* * 
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» # 

» » 

* MMSTAT EVENT GROUP U * 

* SCHEDULING * 
» » 



EVENT UO (J150) 



EVENT NAME: QUIESCE 

DESCRIPTION: PROCESS SWITCH - STATE OF PROCESS SAVED 

CALLING MODULE: KERNELC 
CALLING PROCEDURE: DSP 

PARAMETER DESCRIPTION 



PI = PCBOO(CPCB) 








•(0:1) = 


1 


=> 


SAR - 


SCHEDULING ATTENTION REQUIRED 


.(2:1) = 


1 


a> 


CRIT - 


PROCESS IS CRITICAL 


•(3:1) = 


1 


= > 


HSIR - 


PROCESS HAS SIR 


.(U:l) = 


1 


= > 


PIOVR 


- PENDING PI, PROCESS CRITICAL 


.(5:1) = 


1 


= > 


HSPRI 


- HOLD SIR PRIORITY 


.(6:1) = 


1 


= > 


IPEXP 


- INCORE PROTECT EXPIRED 


.(7:1) = 


1 


= > 


PC 


- PREMPT CAPABILITY 


.(8:1) = 


1 


= > 


MP 


- MUST PREMPT 


.(9:D = 


1 


s> 


LW 


- LONG WAIT 


.(10:1)= 


1 


s> 


SW 


- SHORT WAIT 


•(11:1)= 


1 


= > 


TRW 


- TERMINAL READ WAIT 


.(12:1) = 


■1 


= > 


USEQD 


- USED A QUANTUM SINCE TRANSACTION 
BEGAN 


.(13:1)= 


1 


= > 


HIPRI 


- HOLD IMPEDED PRIORITY 


.(1U:1)= 


1 


= > 


ALLOW 
SYSTEM 


SOFT INTERRUPTS EVEN THOUGH IN 
1 CODE 


•(15:1)= 


1 


= > 


RITBK 


- PROCESS IN RIT BREAK 
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P2 = PCBOU(CPCB) 










.(0:1) = 


1 


=> 


M 


- MOURNING WAIT 


•(1:1) = 


1 


=> 


RG 


- GLOBAL RIN WAIT 


.(2:1) = 


1 


=> 


RL 


- LOCAL RIN WAIT 


•(3:1) = 


1 


=> 


MA 


- MAIL WAIT 


.(U:l) = 


1 


=> 


BIO 


- BLOCKED 10 WAIT 


.(5:1) = 


1 


=> 


10 


- 10 WAIT 


.(6:1) = 


1 


=> 


UCP 


- UCOP WAIT, RIT WAIT 


.(7:1) = 


1 


=> 


JNK 


- JUNK WAIT 


•(8:1) = 


1 


=> 


TIM 


- TIMER WAIT 


.(9:1) = 


1 


=> 


INT 


- INTERRUPT WAIT 


.(10:1)= 


1 


=> 


SON 


- SON WAIT 


.(11:1)= 


1 


=> 


FA 


- FATHER WAIT 


.(12:1)= 


1 


=> 


IMP 


- PROCESS WAITING TO UNIMPEDED 


.(13:D* 


1 


=:> 


SIR 


- PROCESS WAITING FOR SIR 


.(ll»:l)= 


1 


= > 


TIM 


- PROCESS WAITING FOR TIME OUT 


.(1U:1)= 


1 


= > 


MEM 


- PROCESS WAITING FOR MEMORY 


P3 = PCB13(CPCB) 










.(0:1) = 


1 


= > 


DISPQ 


- PROCESS ON DISPATCHING QUEUE 


.(1:1) = 


1 


=> 


L SCHEDULING CLASS 


.(2:1) = 


1 


=> 


C SCHEDULING CLASS 


.(3:1) = 


1 


=> 


D SCHEDULING CLASS 


.(U:l) = 


1 


=> 


E SCHEDULING CLASS 


•(5:1) - 


1 


s> 


INTER- 


- PROCESS IS INTERACTIVE 


.(6:1) = 


1 


=> 


CORER- 


■ PROCESS IS CORE-RESIDENT 


.(8:8) = 


PROCESS' SCHEDULING PRIORITY 
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«*#»##»#»»*»*#««#*«*««********»**»*»*************************** 



* 



* 



» MMMSTAT EVENT GROUP 5 

* (SEE CHAPTER 18 FOR THESE EVENTS) * 

* 

•••••♦••♦•a**************************************************** 
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* 

* MMSTAT EVENT GROUP 6 * 

* FILESYS • 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY » 



EVENT -60(%7U) 



EVENT NAME: FOPEN 
DESCRIPTION: OLD FILE OPEN 



CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:2)=2 -> NON-SPOOLER ACCESS 
(0:2). NE. 2 -> 

P2= AOPTIONS SEE INTRINSICS MANUAL 

P3= FILE LABEL FOPTIONS SEE INTRINSICS MANUAL 

EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: OLD DISC FILE OPEN (CONTINUATION OF EVENT -60) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

Pl= RECORD SIZE 

P2= FILE LABEL BLOCK SIZE 

P3= # OF BUFFERS 
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EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: OLD FILE OPEN (CONTINUATION OF EVENTS -60 & -6l) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE LABEL FILE LIMIT MSW 

P2= FILE LABEL FILE LIMIT LSW 

P3= FILE LABEL # OF EXTENTS 
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EVENT -60(%7U) 

EVENT NAME: FOPEN 
DESCRIPTION: NEW DISC FILE OPEN 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:2)=2 -> NON-SPOOLER ACCESS 

(0:2). HE. 2 -> 
P2= AOPTIONS SEE INTRINSICS MANUAL 

P3= FOPTIONS SEE INTRINICS MANUAL 

EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: NEW DISC FILE OPEN (CONTINUATION OF EVENT -60) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

Pis RECORD SIZE 

P2» BLOCK SIZE 

P3= # OF BUFFERS 
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EVENT -6l(%75) 

EVENT NAME: FOPEN' 

DESCRIPTION: NEW DISC FILE OPEN (CONTINUATION OF EVENT -60 & -61) 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FCB FILE LIMIT 

P2- FCB MAX f EXTENTS 

P3= (0:8)= INITIAL ALLOCATION EXTENTS 
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EVENT -62(%76) 



EVENT NAME: FREAD 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREAD 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= ACBTLOG TRANSFER COUNT 

P3= NOT USED 



EVENT -63(%77) 



EVENT NAME: FWRITE 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FWRITE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= TCOUNT SEE INTRINSIC MANUAL 

P3= NOT USED 



20-20 



EVENT -6U(%100) 

EVENT NAME: FREADDIR 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREADDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= ACBTLOG TRANSFER COUNT 

P3= NOT USED 

EVENT -6U(%100) 

EVENT NAME: FREADDIR* 

DESCRIPTION: CONTINUATION OF EVENT -6U FREADDIR 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREADDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= REC # MSW 

P2= REC # LSW 

P3= NOT USED 
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EVENT -65(%101) 

EVENT NAME: FWRITEDIR 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING MODULE: FWRITEDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILENUM (0:1) BUFFER HIT FLAG 

P2= TCOUNT SEE INTRINSIC MANUAL 

P3= NOT USED 

EVENT -65(%101) 

EVENT NAME : FWRITEDIR ' 

DESCRIPTION: CONTINUATION OF EVENT -65 FWRITEDIR 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FWRITEDIR 

PARAMETERS PARAMETER DESCRIPTION 

Pl= REC # MSW 

P2= REC # LSW 

P3= NOT USED 
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EVENT -66(51102) 



EVENT NAME: FUPDATE 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FUPDATE 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= TCOUNT SEE INTRINSIC MANUAL 

P3= NOT USED 



EVENT -67(%103) 



EVENT NAME: IOWAIT 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: IOWAIT 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= ACBTLOG TRANSFER COUNT 

P3= NOT USED 
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EVENT -68(%10U) 



EVEHT NAME: FREADSEEK 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FREADSEEK 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # (0:1) BUFFER HIT FLAG 

P2= REC # MSW 
P3= REC # LSW 



EVENT -69(%105) 



EVENT NAME: FSPACE 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FSPACE 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= DISPLACEMENT SEE INTRINSIC MANUAL 
P3= NOT USED 
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#«•••««•*##*«•*#**«««*»«*«•««**•**«**************************** 



* 



• MMSTAT EVENT GROUP 7 

* FILESYS # 

« THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 



EVENT -70(%106) 



EVENT NAME: FPOINT 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FPOINT 

PARAMETERS PARAMETER DESCRIPTION 
Pl» FILE # 

P2= REC # MSW 

P3 S LSW LSW 



EVENT -71(%107) 



EVENT NAME: FCONTROL 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FCONTROL 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= CODE SEE INTRINSIC MANUAL 
P3= NOT USED 
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EVENT -72(JJllO) 



EVENT NAME: FSETMODE 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FSETMODE 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= MODEFLAr-S SEE INTRINSIC MANUAL 

P3= 



EVENT -7U(%112) 



EVENT NAME: FCHECK 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FCHECK 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= ERRORCODE SEE INTRINSIC MANUAL 

P3= 



?0-?6 



EVENT -75(%113) 

EVENT NAME: FGETINFO 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FGETINFO 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= FOPTIONS SEE INTRINSIC MANUAL 

P3= AOPTIONS SEE INTRINSIC MANUAL 

EVENT -76(%HU) 

EVENT NAME: FREADLABEL 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: 

PARAMETERS PARAMETER DESCRIPTION 

Pis file # 

P2= TCOUNT SEE INTRINSIC MANUAL 

P3= 
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EVENT 77(£L15) 



EVENT NAME: FWRITELABEL 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FWRITELABEL 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= TCOUNT SEE INTRINSIC MANUAL 
P3= 



EVENT -78(%ll6) 



EVENT NAME: FLOCK 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FLOCK 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= LOCKCOND SEE INTRINSIC MANUAL 

P3= COND CODE SEE INTRINSSIC MANUAL 






EVENT -79(%H7) 



EVENT NAME: FUNLOCK 
DESCRIPTION: 



CALLING MODULE: FILEIO 

CALLING PROCEDURE: FUNLOCK 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FILE # 

P2= 

P3= 
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* * 

* HMSTAT EVENT GROUP 8 * 
» * 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 

» # 



EVENT -80(%120) 

EVENT NAME: FRENAME 
DESCRIPTION: 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FRENAME 

PARAMETERS PARAMETER DESCRIPTION 

Pl= FILE # 

P2= 



P3= 

EVENT -8l(%121) 

EVENT NAME: FCLOSE 
DESCRIPTION: 

CALLING MODULE: FILEACC 

CALLING PROCEDURE: FCLOSE 

PARAMETERS PARAMETER DESCRIPTION 

Fl= FILE # 

P2= DISP SEE INTRINSIC MANUAL 

P3= SECCODE SEE INTRINSIC CODE 
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* » 

* MMSTAT EVENT GROUP 9 * 

* » 

* DISC I/O TRANSFER REQUESTS # 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 

EVENT -98(%ll*2) 

EVENT NAME: DISK TRAFFIC 

DESCRIPTION: DISC I/O REQUEST HAS BEEN QUEUED 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: ATTACHIO 

PARAMETERS PARAMETER DESCRIPTION 

P1=CNT DATA TRANSFER COUNT: WORDS IF >0; 
BYTES IF <0 

P2=FLAGS.(0:U) 

P3=FNCT =0 «>READ 

=1 «>WRITE 
=2 ==>OPEN FILE 
=3 ==>CLOSE FILE 
=U «>CLOSE DEVICE 
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» 
* MMSTAT EVENT GROUP 10 « 

* 

EVENT 100 (JlM) 

EVENT NAME: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLING MODULE: IOFDISC1 

CALLING PROCEDURE: FHDDVR 

PARAMETERS PARAMETER DESCRIPTION 

P1=DIPT(DSTAT) HARDWARE STATUS 
P2=S0 QMISC 

P3=IOQP(QLDEV).QLDEVN LOR STOCOUNTiLSL(8) ) 
=LDEV/SIO PROGRAM COUNTER 

EVENT 101(%lU5) 

EVENT NAME: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLING MODULE: IOMDISCO 

CALLING PROCEDURE: MHDDVR 

PARAMETERS PARAMETER DESCRIPTION 



P1=DIPT(DSTAT) HARDWARE STATUS 
P2=S0 QMISC 

P3=IOQP(QLDEV).QLDEVN LOR STOCOUNTiLSL ( 8 ) ) 
=LDEV/SI0 PROGRAM COUNTER 
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* 
* 

* 

* MMSTAT EVENT GROUP 11 * 

* 

* 
* 

EVENT -110(%156) 

EVENT NAME: START I/O 

DESCRIPTION: DRIVER INITIATOR FOR SIO DEVICE HAS BEEN CALLED 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl=IOQPL(QSTAT) LOR IOQPL(QLDEV) .LDEVN 

=(0:8) PCB ENTRY # OF PROCESS MAKING REQUEST 
(8:8) LOGICAL DEVICE NUMBER OF DEVICE FOR I/O 
P2=I0QP(QWBCT)=W0RD COUNT IF>0;BYTE COUNT IF<0 
P3=(0:2) = FUNCTION CODE SPECIFIED BY DRIVER 

= => READ 
- 1 => WRITE 
= 2 => CONTROL 

=(6:10)= DSTN OF TARGET DATA SEG 

EVENT -111(%157) 

EVENT NAME: I/O COMPLETION 
DESCRIPTION: SIO COMPLETION 

CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

P1=I0QP(QLDEV).LDEVN=L0GICAL DEVICE NUMBER OF 

DISC INVOLVED IN TRANSFER 
P2=I0QP(QPAR1) (DEFINED BY DRIVER) 
P3=IOQP(QPAR2) (DEFINED BY DRIVER) 
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» 

* 
» 

* 

* MMSTAT EVENT GROUP 12 » 

« 



EVENT -120(%170) 



EVENT NAME: DISKSPACE 
DESCRIPTION: BUG CATCHER 



CALLING MODULE: ALLOCATE 

CALLING PROCEDURE: DISKSPACE 

PARAMETERS PARAMETER DESCRIPTION 

P1=PDISKADR<0 ==> GET DISC SPACE AT THIS ADDRESS 
=0 ==>GET N SECTORS ON ANY DISC 
>0 ==>RETURN SPACE 
P2=SEC0ND WORD OF PDISKADR 
P3=LDEV=L0GICAL DEVICE NUMBER OF DISC 



EVENT -121(%171> 



EVENT NAME: DISKSPACE 
DESCRIPTION: BUG CATCHER 



CALLING MODULE: ALLOCATE 

CALLING PROCEDURE: DISKSPACE 

PARAMETERS PARAMETER DESCRIPTION 

P1=NSECT NUMBER OF SECTORS REQUESTED 

P2=W0RD 2 OF NSECT 

Pa^RETURNVAL =0==> OK 

=1 «>I/0 ERROR 

-2 «>INVALID NSECT 

=3 ==>SPACE NOT AVAILABLE 

=1| ==> INVALID DISC ADDRESS 

=5 ==> FREE SPACE TABLE FULL 

EVENT 125 (%175) 

EVENT NAME: IOBUFTRP 

20-3« 



EVENT DESCRIPTION: IOSYSTEM BUFFER TRAP 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: SIODM 

PARAMETER DESCRIPTION 



PI = IOQP 

P2 = IOQP (QDSTN). DSTN = DST NUMBER OF BUFFER 

P3 ■ 
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* * 

* # 

* MMSTAT EVENT GROUP 13 « 

* • 

* (MOT USED) * 



* « 

* • 

* MMSTAT EVENT GROUP lU * 

* « 

* cs/3000 • 

•••••••••••••••••it********************************************* 

EVENT lUO (%2lll) 
EVENT NAME: COPEN 
DESCRIPTION: 

CALLING MODULE: C0MS7S2 

CALLING PROCEDURE: COPEN 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 PMAP1 

P3 PMAP2 
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EVENT 1U2 (%2l6) 



EVENT NAME: CABORTIO 
DESCRIPTION: 



CALLING MODULE: C0MS7S1 

CALLING PROCEDURE: CABORTIO 

PARAMETERS PARAMETER DESCRIPTION 
PI LOGICAL DEVICE 
P2 IOQINDEX 
P3 
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EVENT Ikk (%220) 



EVENT NAME: CSIOWAIT 
DESCRIPTION: 



CALLING MODULE: COMSYS1 

CALLING PROCEDURE: CSIOWAIT 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) - LOGICAL DEVICE NUMBER 

P2 TRANSMISSION LOG 

P3 

EVENT 1U6 (%222) 

EVENT NAME: CCLOSE 
DESCRIPTION: 

CALLING MODULE: COMSYS3 

CALLING PROCEDURE: CCLOSE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) - LOGICAL DEVICE NUMBER 

P2 LINE NUMBER 

P3 



9n--»ft 



EVENT 1U7 (%223) 



EVENT NAME: CREAD 
DESCRIPTION: 



CALLING MODULE: COMSYSU 

CALLING PROCEDURE: CREAD 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) » LOGICAL DEVICE NUMBER 

P2 INCOUNT 

P3 STATION 



EVENT 1U9 (%225) 



EVENT NAME: CWRITE 
DESCRIPTION: 



CALLING MODULE: COMSYSU 

CALLING PROCEDURE: CWRITE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 OUTCOUNT 
P3 INCOUNT 
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« 

« 

* MMSTAT EVENT GROUP IS « 
* 

* CS/3OO0 » 



EVENT 150 (%226) 



EVENT NAME: CSDRIVER 
DESCRIPTION: 



CALLING MODULE: BSCLCM 

CALLING PROCEDURE: CSDRIVER 

PARAMETERS PARAMETER DESCRIPTION 
PI TIMER LSW 



P2 CURRENTSTATE WHERE THE DRIVER IS IN THE 

STATE TRANSITION TABLE 

P3 CURRENTEVENT (0:8) = CURRENT EVENT 

(8:8) = LOGICAL DEVICE 
WHAT CAUSED THE DRIVER TO BECOM 
ACTIVE 



EVENT 152 (%230) 
EVENT NAME: CCONTROL 
DESCRIPTION 



CALLING MODULE: COMSYS5 

CALLING PROCEDURE: CCONTROL 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 CONTROL CODE 

P3 PARAMETER 
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EVENT 153 (%231) 

EVENT IAME: COPENTRACEFTLE 
DESCRIPTION: 

CALLING MODULE: 

CALLING PROCEDURE: COPENTRACEFILE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUMBER 

P2 CTRACEINFO 

P3 

EVENT -15 1 * (*232) 

EVENT NAME: CCLOSETRACEFILE 
DESCRIPTION: 

CALLING MODULE: 

CALLING PROCEDURE: CCLOSETRACEFILE 

PARAMETERS PARAMETER DESCRIPTION 

PI (0:8) * CS ERROR CODE 

(8:8) * LOGICAL DEVICE NUMBER 

P2 

P3 



20-Ul 



EVENT 155 (%233) 

EVENT NAME: CPOLLIST 
DESCRIPTION: 

CALLING MODULE: 

CALLING PROCEDURE: CPOLLIST 

PARAMETERS PARAMETER DESCRIPTION 

PI LOGICAL DEVICE 

P2 CS ERROR CODE 
P3 PMAP 
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**##***•###*««#*##*•*«•******** ft******************************** 

* • 

* MMSTAT EVENT GROUP 16 * 

« • 

* • 



EVENT 160(%2J*0) 



EVENT NAME: CREAD 
DESCRIPTION: 

CALLING MODULE: DSMON 

CALLING PROCEDURE: 



PARAMETERS 



PARAMETER DESCRIPTION 



PI- TIME STAMP 

P2= (0:U) NOT USED 
(U:l) BLOCK 
(5:2) STATE 
(7:3) NEXT 
(10:1) :=0 INITIALIZATION EVENT 

:=1 COMPLETION EVENT 
(11:5) SUB EVENT NUMBER 

P3= DEPENDS ON THE SUB EVENT NUMBER AND 

IF ITS A INTIALIZATION OR COMPLETION EVENT. 
MSG: (0:U) STRMTYPX 

(U:6) MSG CLS 

(10:16) STRMTYP 



SUB 


SUB EVENT 


INIT 


EVENT NO. 


NAME 


PARM 





CREAD 





1 


CWRITE 


Z MSG 


2 


IOWAIT 





3 


CCHECK 





U 


DSATTN 





5 


DSWC 


X MSG 


6 


CHNGEWAIT 


PARM 


7 


MONREQ 


REQ 


10 


CABORT 





11 


CRESET 





12 


CSDATA 


R MSG 


13 


CSREREAD 





COMP 
PARM 

LEN 
LEN 
LEN 
ERRCOD 


R MSG 




T/F 
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« • 

* • 

* MMSTAT EVENT GROUP 19 * 

* * 

» • 



EVENT 19K%277) 

• 

EVENT NAME: DISKINTRPT 

DESCRIPTION: A 7905/7920 CONTROLLER IS PROCESSING AN ATTENTION INTERRUPT 
(ONLINE/OFFLINE) 
CALLING MODULE: HARDRES 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl= €DITP (US)--ie.WHO GOT THE INTERRUPT 



P2= gDITP 



(THEM)--ie. WHO RAN THE POLL PROGRAM 



P3= DITP 



'OUR" DIT FLAGS WORD 



THERE SHOULD BE AT LEAST AN %300 AND AN %303 FOR EACH SIO PRGM. 
A SINGLE ISOLATED (IN TIME) REQUEST WILL GENERATE AT LEAST A 
%303 , %300, %303. IF THE QUEUE OF IOQE'S ON A DIT NEVER EMPTIES 
THERE WOULD BE ONE %300 AND ONE %303 PER SIO PRGM. 
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EVENT 192 (%300) 



EVENT NAME: GIPINTERUPT 

DESCRIPTION: INTERRUPT JUST PROCESSED 



CALLING MODULE: HARDRES 
CALLING PROCEDURE: GIP 
PARAMETERS 

Pl= (0:7) 



(8:9) 



PARAMETER DESCRIPTION 

LDEV note a) its easy to read in oct 
b) ldevs > 127 will 
be recorded mod 128 
ADDRESS CONTAINED IN DRT WORD RE- 
LATIVE TO SIO PROGRAM AREA (ie where 
did it stop?) 
ABS (DRTN*1»)- (ILTP(ISIOP)+SYSDB) ) 



P2= DEVICE STATUS (the TIO GIP just did) 



P3= LSW of a call to TIMER 
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EVENT 195(%303) 

EVENT NAME: SIODM 
DESCRIPTION: LEAVING SIODM 

CALLING MODULE: CRIO 

CALLING PROCEDURE: SIODM 

PARAMETERS PARAMETER DESCRIPTION 

Pl= (0:7) LDEV -- SAME AS 192(%300) 

(8:9) a IOQ table relative index 

to convert this into the number that 
is formated by DPAN2, multiply this num 
ber by %13 and add %10,that will be the 
number in the left column of returned 
IOQ'S — add the table base to get the 
DPAN number for "in-use" enries. 



P2= DIT WORD (DIT FLAGS) -- note that P2.(12:l*) 
contains the state we are "leaving" 

P3= (0:U) THE CONTENTS OF DIT0.(12:U) 
ie, the state we entered in 

(U:12) LSW OF TIMER — note the difference 

between P3 of %300 and 
P3 of %303, these 12 bit 
will hold "U.l seconds w 
is enough for 30229 con- 
trollers purpose and DS 
timeouts (some types). 
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» 
* 

* 



* MMSTAT EVEKT GROUP 20 
* 

* THESE EVENTS ARE FOR DEVELOPMENT USE ONLY * 



EVENT 200(%310) 



EVENT NAME: DISKBUGCATCHER 
DESCRIPTION: 



CALLING MODULE: PVSYS 

CALLING PROCEDURE: MVTABLE 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FUNCT 

P2= MVTABX 

P3= DELTAP 



EVENT 201(%311) 



EVENT NAME: DISKBUGCATCHER 
DESCRIPTION: 



CALLING MODULE: PVSYS 

CALLING PROCEDURE: USERTABLE 

PARAMETERS PARAMETER DESCRIPTION 
Pl= FUNCT 
P2= MVTABX 
P3= DELTAP 
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« » 

* * 

* MMSTAT EVENT GROUP 21 * 

* PROCESS CREATIONS AND TERMINATIONS * 

* LOGICAL PROCESS TABLE * 

* • 

EVENT -211(%323) 

EVENT NAME: PROCESS COMPLETION 
DESCRIPTION: PROCESS HAS TERMINATED 

CALLING MODULE: MORGUE 

CALLING PROCEDURE: TERMINATE 

PARAMETERS PARAMETER DESCRIPTION 

P1=0 
P2=0 
P3=0 
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* * 

» MMSTAT EVENT GROUP 22 * 

# * 

* TIME STAMP OF EVENT TRACE ENABLE AND DISABLE * 



EVENT 221(%335) 

EVENT NAME: CONFIGURATION INFORMATION 
DESCRIPTION: EVENT GROUP MASK 

CALLING MODULE: CRIO 

CALLING PROCEDURE: CONSMON 

PARAMETERS PARAMETER DESCRIPTION 
Pl= MEASMSKO 
P2= MEASMSK1 
P3= 
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EVENT 222(%336) 

EVENT NAME: CONFIGURATION INFORMATION 
DESCRIPTION: MPE VERSION FIX UPDATE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl= VERSION 

P2= FIXL 

P3= UPDATEL 



EVENT -223 (-%337) 

EVENT NAME: CONFIGURATION INFORMATION 

DESCRIPTION: SYSTEM TABLE LOCATIONS AND AVAILABLE LINKED MEMORY 
INFORMATION 
CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

P1=F (%1032 ) =«CST ( ) -8DST ( ) 

=DISPLACEMENT TO CODE 

P2=F(%1033)=eCST(LAST) -gDST(O) 

^DISPLACEMENT TO SHARABLE 

P3=LOGICAL(TOTAL&DLSK(1»))=LINKED MEMORY SIZE 
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EVENT -22U -(%3 J *0) 

EVENT NAME: S7SPINS 

DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 



Pl=ABSOLUTE(%llUl)=PROGEN'S PCBENTRY NUMBER 
P2=ABSOLUTE(%llU2)=MAM'S PCB ENTRY NUMBER 
P3=ABSOLUTE(%lll*3)=UCOP'S PCB ENTRY NUMBER 



EVENT -225 i-%3^1) 

EVENT NAME: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl=ABSOLUTE(%llUU)=PFAIL'S PCB ENTRY NUMBER 
P2=ABSOLUTE(%m*5)=DEVREC'S PCB ENTRY # 
P3=ABSOLUTE(%lll46)=PRMSG'S PCB ENTRY # 



EVENT -226 (-%3^2) 

EVENT NAME: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl=ABSOLUTE(%llU7)=STMSG'S PCB ENTRY # 
P2=ABSOLUTE(%1150)=LOG'S PCB ENTRY # 
P3=ABSOLUTE(%1151)=LOAD , S PCB ENTRY # 
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EVENT -227 (-%3^3) 

EVEHT NAME: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

Pl=ABSOLUTE(%1152)=IOMESSPROC'S PCB ENTRY # 
P2=ABSOLUTE(%1153)=SYSIOPROC'S PCB ENTRY # 
P3=ABSOLUTE(%115lt)=MEMLOGP'S PCB ENTRY # 



EVENT -228 (%3l*U) 



EVENT NAME: TIMESTAMP 
DESCRIPTION: TIMESTAMP 



CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

P1=CALENDER (0:7)=YEAR OF CENTURY 
(7:9)=DAY OF YEAR 

P2=CLOCK(WORD1).(0:7)=HOUR OF DAY 

(8:8)=MINUTE OF HOUR 

P3=CLOCK(WORD2).(0:7)=SECONDS INTO MINUTE 
. (8:8)=TENTHS OF SECONDS 

EVENT -229 (-%3U5) 

EVENT NAME: MONOFF 
DESCRIPTION: END EVENT TRACING 

CALLING MODULE: OPCOMMAND 

CALLING PROCEDURE: CXMON 

PARAMETERS PARAMETER DESCRIPTION 

P1=0 
P2=0 
P3=0 
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#»*»#####****#*****««*****»***»*»**** lr ************************* 

* 
« 

* 

* MMSTAT EVENT GROUP 23 

* 'X'Eji^MXliALi X/v/ 

• 



EVENT 230 (%3U6) 



EVENT NAME: TERMREAD 

DESCRIPTION: TERMINAL READ COMPLETION 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 



PI = LDEV 

P2 - READ DURATION 

P3 = BYTES READ 



EVENT 231 (%3U7) 



EVENT NAME: DC1DC2ACK 

DESCRIPTION: DC1/DC2 HAS BEEN SATISFIED 

CALLING MODULE: HARDRES 
. CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = DURATION (BETWEEN START AND DC2) 

P3 = BYTES READ (EXCLUDING DC2) 



» 
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EVENT 232 (%350) 



EVENT NAME: TERMWRITE 
DESCRIPTION: WRITE COMPLETION 

CALLING MODULE: IOTERMO 
CALLING PROCEDURE: TERMIOM 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = 

P3 ■ BYTE COUNT OF TRANSFER 



EVENT 233 (%35D 



EVENT NAME: BINREAD 

DESCRIPTION: BINARY READ COMPLETED 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = DURATION 

P3 ■ BYTES READ 
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EVENT 23 1 * (%352) 



EVENT NAME: TERMLOGON 

DESCRIPTION: TERMINAL JUST LOGGING ON 

CALLING MODULE: IOTERMO 
CALLING PROCEDURE: TERMIOM 

PARAMETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = 

P3 - 



EVENT 235 (%353) 



EVENT NAME: TERMLOGOFF 

DESCRIPTION: TERMINAL JUST LOGGED OFF 

CALLING MODULE: IOTERMO 
CALLING PROCEDURE: TERMIOM 

PARAMETERS PARAMETER DESCRIPTION 
PI = LEEV 
P2 = 
P3 ■ 
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EVENT 236 (%35 1 ») 



EVENT NAME: SPECCHAR 

DESCRIPTION: PROCESSED SPECIAL CHARACTER 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = SPECIAL CHARACTGER PROCESSED 

P3 ■ 



EVENT 237 (%355) 

EVENT NAME: BREAK 
DESCRIPTION: PROCESSED BREAK 

CALLING MODULE: HARDRESS 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = DSTATE 
P3 - 
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EVENT 238 (%356) 



EVENT NAME: SPECREAD 

DESCRIPTION: SPECIAL READ TERMINATION CHARACTER DETECTED 

CALLING MODULE: HARDRES 
CALLING PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 

PI = LDEV 

P2 = DURATION 

P3 = BCNT 
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